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PREFACE 



This manual describes the Network Operating System (NOS) version 1.4. NOS controls the 
operation of CDC® CYBER 170 Series; CDC CYBER 70 Series, models 71, 72, 73, and 74; 
and CDC 6000 Series Computer Systems. 



ORGANIZATION 

The NOS Reference Manual is contained in two volumes to separate information useful only 
to fee COMPASS programmer from information useful to all NOS users. 

Volume 1 contains information for all NOS users. This includes a general description of 
the system and its handling of files and jobs, detailed descriptions of control language and 
control statement formats and processing, and explanations of memory dumps and other 
debugging aids. Appendixes contain NOS character sets, messages, and a glossary. 

Volume 2 contains information of use primarily to the COMPASS programmer; however, 
several sections contain information for users of higher level languages. For reference, 
the table of contents of volume 2 follows the table of contents of this volume. 



CONVENTIONS 

Throughout this manual, cross-references to the NOS Reference Manual, volume 2, are 
in the form: refer to section (or appendix) n, volume 2. If volume 2 is not stipulated, the 
reference is to volume 1. 

Uppercase letters within statement formats should be entered exactly as given; lowercase 
letters should be replaced with appropriate characters as described after the format. 

Extended memory for the CDC CYBER 170 models 171. 172, 173, 174, 175, 720, 730, 750, 
and 760 is extended core storage (ECS). Extended memory for CDC CYBER 170 model 176 
is large central memory (LCM) or large central memory extended (LCME). ECS and LCM/ 
LCME are functionally equivalent, except as follows: 

• LCM/LCME cannot link mainframes and cannot use a distributive data path (DDP). 

• LCM/LCME transfer errors initiate an error exit, not a half exit. Refer to the 
COMPASS Reference Manual for complete information. 

Model 176 supports direct LCM/LCME transfer COMPASS instructions (octal codes 014 

3nA F\t K\ Qnfcf +^ +K*» f^f^TilfO A^^ Pofor^nno TMannal fr\T» £* n I"" *"»' ****** infnrmflHnn. 

In this manual, ECS refers to all forms of extended memory on the CDC CYBER 170 Series. 
However, the model 176 extended memory is excluded in references to ECS access through 
the DDP and to multimainframe ECS linkage. 
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AUDIENCE 

'This manual is written for all NOS users. Users can understand the manual contents 
without knowing the NOS assembler language, COMPASS. However, they should read the 
NOS 1 Batch User's Guide and/or the Network Products IAF User's Guide or the NOS 1 
Time-Sharing User's Guide before reading this manual. 

Users are urged to consult the glossary in appendix C for definitions of terms used in this 
manual. 



RELATED PUBLICATIONS 

Information on NOS system operation, the NOS product set, and time-sharing commands 
is given in the following listed manuals. Separate manuals describe CDC CYBER Record 
Manager and CDC CYBER Loader. The NOS Applications Programmer's Instant contains 
a list of the product control statements and their parameters. The Manual Abstracts 
booklet for NOS gives a short description of the contents of the following manuals- Rpfpr- 
to the Literature Distribution Services catalog for the latest revision levels. 



Control Data Publication 

ALGOL Version 4 Reference Manual 

ALGOL Version 5 Reference Manual 

APEX III Version 1 Reference Manual 

APL Version 2 Reference Manual 

Application Installation Handbook 

APT IV Version 2 Reference Manual 

BASIC Version 3 Reference Manual 

CDCS Version 1 Reference Manual 

COBOL Version 4 Reference Manual 

COBOL Version 5 Reference Manual 

Common Utilities Reference Manual 

COMPASS Version 3 Reference Manual 

CYBER Interactive Debug Reference Manual 

CYBER Record Manager Advanced Access Methods 
Version 2 Reference Manual 

CYBER Record Manager Basic Access Methods 
Version 1.5 Reference Manual 

CYBER Loader Version 1 Reference Manual 

CYBER 170 Computer Systems Models 720, 730, 750, 760, and 
176 (Level B) Hardware Reference Manual 

CYBER 170 Computer Systems Reference Manual 

CYBER 70 /Model 71 Computer System Reference Manual 

CYBER 70 /Model 72 Computer System Reference Manual 

CYBER 70/Model 73 Computer System Reference Manual 

CYBER 70/Model 74 Computer System Reference Manual 
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60496600 
60481600 
76070000 
60454000 
76071100 
17326900 
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60498700 
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60497100 
60495600 
60492600 
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60499300 
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60347200 
60347400 
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«*— «& Manual Abstracts 

Modify Reference Manual 

Modify Instant 

Network Products Interactive Facility Version 1 
Reference Manual 

Network Products Interactive Facility Version 1 User's Guide 

Network Products Network Access Method Version 1 
Network Definition Language Reference Manual 

— ^ Network Products Network Access Method Version 1 
Reference Manual 
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Reference Manual 
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CRM Data Manager Reference Manual 
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Data Manager Reference Manual 
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Reference Manual 
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Version 3 Reference Manual 
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DISCLAIMER 

This product is intended for use only as described in this document. Control Data cannot 
be responsible for the proper functioning of undescribed features or undefined parameters. 
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SYSTEM DESCRIPTION 



NOS is capable of several concurrent processing modes. The following are the available 
processing modes. 

• Local batch. 

• Remote batch. 

• Transaction. 

• Time-sharing. 

The network processing modes (remote batch, transactio n, and time- sh aring) operate 
through the Network Access Method s (NAM) co mmunications s of twa re . TEeSe processing 
modes are implemented, respectively, by the following NAM applications: Remote Batch 
Facility (RBF), Transaction Facility (TAF), and Interactive Facility (IAF). 

NOS can,, also perform time-sharing and transaction processing through the time- sharin g 
exeeatiae and remote batch processing through Export /import. 

The primary emphasis of this manual is on local batch processing. Users of the other 
processing modes should consult the appropriate manual listed in the preface. 

NOS, like all operating systems, is the interface between user software and the capabilities 
of system hardware components. The remainder of this section describes the hardware and 
software that make up a NOS-controlled computer system. In most cases, the user of this 
manual need not understand the operation of system hardware or the internal operation of 
system software. This manual describes these topics only as general background for 
understanding NOS control statements. 



SYSTEM HARDWARE 

NOS can operate within the CDC CYBER 170 Series; CDC CYBER 70 Series, Models 71, 72, 
73, and 74; and 6000 Series Computer Systems. The primary hardware components of each 
system are the following. 

Central processor unit. 

Central memory. 

Extended memory. 

Peripheral processors. 

Peripheral equipment. 
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CENTRAL PROCESSOR UNIT 

The central, processor unit (CPU) executes instructions and manipulates and stores data 
retrieved from central memory. The number of CPUs within a mainframe and their type 
varies with the machine model. As a result, some models can execute additional COMPASS 
assembler instructions (refer to the COMPASS Reference Manual). These model differences 
do not affect applications written in higher level languages. 

CDC CYBER 170 and CDC CYBER 70 Series Computer Systems have the central exchange 
jump/monitor exchange jump (CEJ/MEJ) feature. This feature enables the system to 
switch CPU control between the system monitor and other programs. The information 
transferred from the CPU to central memory by an exchange jump operation is called an 
exchange package. Section 12 describes the format and use of an exchange package dump. 



CENTRAL MEMORY 

The primary functions of central memory (CM) are: 

• To buffer data to and from the peripheral processors. 

• To transfer instructions and data to and from the CPU. 

Control Points 

Several jobs can reside in CM simultaneously. To separate and control each job while it is 
resident in CM, the system assigns it to a control point. The control point is assigned a 
starting CM address (its reference address or RA) and allocated an initial field length (the 
CM words in which the job is executed). The field length is adjusted during job execution 
as described in section 3. Figure 1-1-1 shows a job field length within CM. 

A reference to an address outside the control point address range causes a hardware error 
condition and job termination. 

NOS supports up to 23 simultaneous control points. The maximum field length depends on 
the CM size and installation parameters used to control memory usage. The system assigns 
the CPU to control points requiring CPU activity. Rapid switching of CPU control between 
control points enables jobs to execute concurrently. The exact amount of time allowed for 
each control point depends on system activity and system parameter settings. Thus, the 
time required to complete a job may vary, although the actual CPU execution time is the 
same. 

When a job completes, aborts, or rolls out (that is, its execution is suspended), the control 
point is released and made available to another job. 
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Figure 1-1-1. Central Memory Allocation 



Central Memory Resident 

The portion of CM reserved for system use is called central memory resident (CMR). It 
contains system tables, directories, and the CM portion of the system monitor (CPUMTR). 
Because its RA is always address and its field length (FL) is the size of central memory, 
CMR can access any CM address and therefore specify addresses for CPU exchange jumps 
that switch CPU control between control points. 



EXTENDED MEMORY 

Extended memory (EM) is available as large central memory (LCM) or large central 
memory extended (LCME) on the CYBER 170 model 176 or as extended core storage (ECS) 
on other NOS systems. References to ECS in this manual refer to ECS, LCM, and LCME 
unless otherwise noted. 

Slower than CM, but faster than mass storage, EM can be used for the following purposes. 

• As a directly accessible memory device via FORTRAN or COMPASS statements 
for ECS data storage and retrieval. (Refer to the FORTRAN Extended 4 Reference 
Manual, FORTRAN 5 Reference Manual, or appendix D of volume 2.) 

* As storage for frequently accessed data. Refer to the ASSIGN statement in section 
7 and Permanent File Control Statements in section 8. 

e As an alternate system device for storing copies of frequently used routines. 

e As a link between mainframes in a multimainframe configuration.? 

Only validated users can use EM (refer to the LIMITS statement in section 6). 



t CYBER 170 model 176 extended memory cannot link mainframes. 
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PERIPHERAL PROCESSORS 

The peripheral processors (PPs) process communications between CM and individual 
peripheral devices. They also perform those system control functions that are better 
handled by a PP than by the central processor. A peripheral processor can: 

• Read and write CM. 

• Read and write ECS indirectly via CM or directly via the distributive data path 
(DDP).t 

• Transfer data to and from peripheral devices through the data channels. 

NOS supports the 7, 8, 9, 10, and 20 PP configurations for 6000 series computers and 10. 
14. 17. and 20 PP configurations for CDC CYBER 70 models 71, 72, 73, and 74. NOS 
also supports 10, 14, 17, and 20 PP configurations for all CDC CYBER 170 models except 
model 176. CYBER 170 model 176 has two types of peripheral processors, PPs and PPUs. 
The configuration supported by NOS can have 2, 4, or 6 PPUs and from 10 to 20 PPs. 

For further information on PPs, refer to the appropriate system hardware reference 
manual listed in the preface. 



PERIPHERAL EQUIPMENT 

Peripheral equipment varies among installations but usually includes card readers and 
punches, line printers, mass storage devices, and magnetic tape units. NOS supports 
the following equipment models. 

405 Card Reader 

415 Card Punch 

580-12, 580-16, and 580-20 Line Printers 

844-21 Disk Storage Subsystem 

844-41 and 844-44 Disk Storage Subsystems 

885 Disk Storage Subsystem 

667, 669, 677, and 679 Magnetic Tape Units 

6671 Multiplexers for communication with 200 User Terminals and 731-12, 732-12, 
and 734 Remote Batch Terminals 

6671 or 6676 Multiplexers for communication with interactive terminals 

255x Network Processing Units 



t This function does not apply to CYBER 170 model 176 peripheral processors. 
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SYSTEM SOFTWARE 

Software executed within a computer system can be divided between software that is built 
into the system during system initialization and software that executes as jobs within the 
running system. Software present when the system begins running includes the operating 
system and products such as compilers, CDC CYBER Loader, and CDC CYBER Record 
Manager. Jobs run within the system are categorized according to their origin as described 
in section 3. User jobs usually consist of user programs and the system instructions 
required for program execution. 



USER PROGRAMS 

A user program is a group of CPU instructions defined by a user to perform a certain task 
or calculate a result. A user program can be written in a language at any of three levels. 

• Compiler languages provide the user with a language suited to his particular needs. 
The program statements are translated by the appropriate compiler (FORTRAN, 
COBOL, ALGOL, and so on) that generates assembler language or machine 
language instructions. Programs written in compiler languages are usually 
machine-independent. 

• Assembler languages provide a one-to-one relationship between instructions and 
machine operation. Mnemonics are provided for each instruction. These languages 
are normally used by advanced programmers because they are machine- dependent. 
Most of the NOS system is written in COMPASS, the assembler language of the 
CDC CYBER 170, CDC CYBER 70, and 6000 series computers. 

• Hardware instructions are interpreted directly by the computer, and therefore, 
require no interpretation by a compiler or assembler. Each hardware instruction 
is a binary number. The programmer is rarely concerned with instructions written 
at this level. The exception is when program debugging requires that the user 
interpret memory dumps. 



OPERATING SYSTEM 

NOS is a group of CPU and PP programs that supervise and coordinate the operation of 
system hardware and the execution of products and user programs. The following lists 
some of the functions of NOS. 

Job validation and accounting. 

Control statement translation. 

File retrieval, manipulation, routing, and storage. 

Job input and output. 

Normal and abnormal job termination. 

Memory dumps. 
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CYBER Loader 

CYBER Loader prepares programs for execution. Following user directions, it allocates 
memory for a program, loads the program modules into their appropriate locations, 
generates a load map, and initiates program execution. It can load subdivided programs 
for more efficient use of memory. Refer to the CYBER Loader Reference Manual for 
more information. 



CYBER Record Manager 

CYBER Record Manager (CRM) is the interface between user I/O functions and NOS physical 
I/O functions. Some of the products that use CRM are COBOL 4, COBOL 5, FORTRAN 
Extended 4, FORTRAN 5, Sort /Merge 4, ALGOL 4, ALGOL 5, PL/l, and DMS-170. 

The functions of CRM are divided between two processors, Basic Access Methods (BAM) 
and Advanced Access Methods (AAM). BAM handles sequential and word-addressable file 
organizations; AAM handles indexed sequential, direct access, and actual key file organiza- 
tions. Refer to the appropriate CYBER Record Manager manual listed in the preface. 
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FILES 



A file is the largest collection of information addressable by name. All NOS data processing 
involves operations performed on files. Files can be differentiated by their name, structure, 
or file type or by whether they are assigned to a job (NOS jobs are described in section 3). 



FILE NAMES 

Each file has a unique 1 to 7 alphanumeric character name, t 

Examples: 

A 123 TAPE 1A2B COMPILE 

Several file names are reserved for system use or have special significance to the system. 
The following file names are reserved for use by system routines. 

SCR SCR1 SCR2 SCR3 SCR4 

Improper use of these file names produces the following dayf ile message. 

RESERVED FILE NAME. 

Many NOS products such as COMPASS, FORTRAN Extended 4, and UPDATE use internal 
scratch files. Many of these scratch files have names beginning with ZZ. The user should 
avoid using the name of a product scratch file for one of his own files. 

The following file names are significant because they are associated with system input, 
print, or punch queues or with time-sharing terminals. 

INPUT OUTPUT PUNCH PUNCHB P8 

Refer to the description of input, print, and punch file types for more information. 



FILE STRUCTURE 

File structure within a computer system has several meanings. Logical file structure is 
how the user orders his data. He can define this logical file structure using higher-level 
language statements within a source program. CRM translates the higher- level language 
statements into the file structure that it superimposes on the data. NOS converts the NOS 
file and record marks that structure a file while it is being processed within the system to 
their physical tape, disk, or card equivalents when the file is stored. 



t Some products such as FORTRAN Extended 4, FORTRAN 5, and COBOL 5 do not support 
file names that begin with a digit. Refer to the product reference manual for details. 
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CYBER RECORD MANAGER FILE STRUCTURE 

CYBER Record Manager handles input/output (I/O) for several products (refer to section 1) 
including FORTRAN Extended 4, FORTRAN 5, and COBOL 5. CRM superimposes its file 
structure on the NOS file structure. Through CRM, the user can specify a file organization, 
a blocking type, and a record type for his data. The file organization determines how 
records are accessed, the blocking type determines how CRM records are grouped on their 
storage media, and the record type defines the smallest unit of data CRM can retrieve. 
The user who wants to use CRM file functions directly should consult the CRM manuals listed 
in the preface. 



NOS FILE STRUCTURE 

A NOS file can contain more than one logical file; if it does, it is called a multifile file. 
A multifile file begins at beginning-of- information (BOI) and ends at end-of- information 
(EOI). A file within a multifile file begins either at BOI or after the end-of-file (EOF) of the 
preceding file. It ends at its EOF. 

Each file consists of one or more records of information. A record is one or more 60-bit 
CM words. A record begins at the BOI, after an EOF, or after the end-of-record (EOR) of 
the preceding record. It ends at its EOR. The following is the structure of a single-record 
file. 

(BOI) data (EOR) (EOF) (EOI) 
The following is the structure of a multirecord, multifile file. 

(BOI) data (EOR) data (EOR) (EOF) data (EOR) data (EOR) (EOF) (EOI) 
The last EOF in a file is optional. 



PHYSICAL FILE STRUCTURE 

When NOS stores a file, it converts it to a structure that conforms to the physical 
characteristics of the storage medium. Its file and record marks are converted to physical 
BOI, EOR, EOF, and EOI indicators. 

The basis of all physical file structures is the physical record unit (PRU), the amount of 
data that can be read or written in a single device access. Table 1-2-1 lists the PRU size, 
and record and file mark indicators for each supported storage device. 
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TABLE 1-2-1. PHYSICAL FILE STRUCTURE ON STORAGE DEVICES 



Storage Device 



PRU Size 



Record and File Mark Indicators 



BOI 



EOR 



EOF 



EOI 



Magnetic disk 
or extended 
memory 



64 CM words. 



Disk address 
for the file in 
the NOS Tile 
name table 
(FNT/FST). 



PRU of less 
than 64 words 
with a link to 
the next PRU. 



Zero- length 
PRU (no data) 
with special 
link to next 
PRU. 



Zero- length 
PRU with no 
forward link. 



Card deckst 



One card. 



First card in 
the deck. 



Magnetic 
tapettt 



I 
(Internal) 



Integral number 
of CM words (0 
to 512); each 
PRU includes a 
48-bit 
terminator. 



SI 
(System 
internal) 



Integral number 
of CM words (0 
to 512); each 
PRU of less 
than 512 words 
has a 48-bit 
terminator. 



(Stranger) 



Maximum of 
512 words 
(refer to BS 
parameter on 
COPY statement 
in section 7 and 
to appendix J in 
volume 2). 



(Long block 
stranger) 



No maximum 
defined (refer 
to BS param- 
eter on COPY 
statement in 
section 7 and 
to appendix J 
in volume 2). 



F 
(Foreign) 



Determined by 
C or FC para- 
meter on 

ASSIGN, 
LABEL, or 
REQUEST 
statement. 



Card with a 
7/8/9 punch in 
column 1. 



Card with 
6/7/9 punch in 
column 1. Tf 



If unlabeled, 
tape mark fol- 
lowing HDR1 
label. If un- 
labeled, load 
point. 



A PRU of less 
than 512 words 
with level num- 
ber of 0. 



Zero-length 
PRU whose 
terminator 
contains a 
level number 
of 17„ 



8 - 



If labeled, tape 
mark following 
HDR1 label. 
If unlabeled, 
load point. 



A PRU of less 
than 512 words 
with level num- 
ber between 
and 16.. 



If labeled, tape 
mark following 
HDR1 label. If 
unlabeled, 
load point. 



End of each 
PRU. 



If labeled, tape 
mark following 
HDR1 label. 
If unlabeled, 
load point. 



End of each 
PRU. 



Load point. 



None. 



Zero- length 
PRU whose 
terminator 
contains a 
level number 
of 17,. 



Tape mark. 



Tape mark. 



Tape mark. 



t For more information, refer to appendix F. 
TT The EOF card is not recognized in a remote batch job. 
TTT For more information, refer to section 10 and appendix G. 



Card with 
6/7/8/9 punch in 
column 1. 



Tape mark fol- 
lowed by an 
EOF1 label. 



Tape mark fol- 
lowed by an 
EOF1 label. 



If labeled, a 
tape mark fol- 
lowed by an 
EOF1 label. If 
unlabeled, there 
is no EOI 
indicator. 



If labeled, a 
tape mark fol- 
lowed by an 
EOF1 label. If 
unlabeled, there 
is no EOI 
indicator. 



None. 
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Card Files 

The physical file and record marks of a card file are shown in figure 1-2-1 and listed in 
table 1-2-1. Although card decks do not have a defined PRU size, a card is the minimum 
data unit. NOS can read and punch cards in coded (Hollerith), binary, and absolute binary 
formats as described in appendix F. Coded cards are punched in 026 or 029 keypunch 
mode. The system uses the installation default keypunch mode (chosen by the installation) 
unless a 26 or 29 is punched in columns 79 and 80 of a job, EOR, or EOF card indicating 
that the subsequent cards are punched in that mode, t NOS can punch up to 80 characters 
on a coded card and up to 150 characters (15 CM words) on a binary card. 



EOR 



BOI 




Figure 1-2-1. Sample Card File Structure 



Mass Storage Files 

Mass storage files are stored on disk or ECS. 

The physical structure of mass storage does not concern most users; they interact with the 
logical structure, with logical devices and logical tracks. A logical device is one or more 
physical disk units known to the system as a single device. A logical track is a file alloca- 
tion unit determined by the device type (refer to table 1-2-2). 



t Keypunch mode selection is not supported for jobs entered through a 200UT or similar 
remote batch terminal. 
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TABLE 1-2-2. LOGICAL STRUCTURE OF SUPPORTED MASS STORAGE DEVICES 



Mass Storage Device 


Number of Units in 
a Logical Device (n) 


PR Us in a Logical 
Track 


844-21 disk (half-track)t 


1 through 8 


n * 107 


844-21 disk (full-track)t 


1 through 8 


n * 112 


844-41/44 disk (half- or 
full-track) 


1 through 8 


n * 227 


885 disk (half- or full- 
track) 


1 through 3 


n * 640 


ECS 


Undefined 


16 



Each permanent file on mass storage is accessed via a catalog track containing the perma- 
nent file catalog of its owner. Indirect access files (refer to Permanent Files) must reside 
on the same device as their catalog; direct access files may reside on another device. 
Space is allocated for mass storage files in units called reservation blocks. An indirect 
access file reservation block is always 64 words (one PRU). A direct access file reserva- 
tion block is a logical track. Within the user validation limits (refer to the LIMITS state- 
ment in section 6), the maximum size of an indirect access file is the device size minus 
space allocated for catalogs and other files. The size of a direct access file is limited 
only by the device size and user validation limits. 



Magnetic Tape Files 

NOS supports tape units that read and write 7-track and 9-track, 1/2-inch magnetic tape 
in binary and coded recording modes. In binary mode, NOS reads and writes 6-bit display 
code. In coded mode, NOS converts display code to and from coded characters. The user 
can select 8-bit ASCII or EBCDIC for coded 9-track tapes. Coded 7-track tapes use 6-bit 
external BCD code. 

The user can select 200, 556, or 800 bits per inch (bpi) density for 7-track tapes or 800, 
1600, or 6250 characters per inch (cpi) density for 9-track tapes, provided these densities 
are available with the site hardware. NOS automatically processes tape parity errors and 
end-of-tape conditions unless the user selects other processing options (refer to Processing 
Options in section 10). 



T Half-track is a recording mode that accesses alternate PRUs during a disk revolution; 
full-track recording mode accesses consecutive PRUs. Half-track mode needs two 
revolutions to access all PRUs on a physical track; full-track mode needs onlv one 
revolution. 
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Tape Labels 

Tape labels identify and delimit tape volumes and tape files. Tape marks begin and end 
tape labels. A tape mark is a special bit sequence written and recognized by a tape unit. 

NOS processes ANSI standard and nonstandard labeled tapes. Nonstandard labeled tapes 
are those whose format or content do not conform to the ANSI standard described in appendix 
G. NOS skips to the first tape mark when reading a nonstandard labeled tape if the tape 
assignment statement specifies the LB=NS parameter (refer to section 10). All information 
after the first tape mark is then handled as data. 

ANSI standard labels are those that conform to the American National Standard Magnetic 
Tape Labels for Information Interchange X3. 27-1969 standard. NOS can create or verify 
ANSI labels if the LABEL statement assigns the tape file. Label verification ensures that 
the correct volume has been mounted. ANSI labels separate multifile set files and indicate 
if a file continues on another volume. 



File set configurations (* means tape mark): 





Single file on single volume 
(A) 
















(A) 








VOL1 


HDR1 


# 


File A data /) 


* 


EOF1 


* 


» 




Single file on more than one volume 
(A) 




Volume 
1 


VOL1 


HDR1 




File A data < / 


• 


EOV1 


* 


* 




(A) 


(A) 


Volume 
2 


VOL! 


HDR1 


» 


File A data \ > 


* 


EOF1 


* 


# 




More than one file on a single volume 

(A) (A) (B) 


(B) 




VOL1 


HDR1 


• 


File A data < / 


* 


EOF1 


* 


HDR1 


# 


File B data 


* 


EOF1 


• 


• 




Wore than one file on more than one volume 

(A) (A) (B) 




Volume 
1 


VOL1 


HDR1 


* 


File A data // 


• 


EOF1 


• 


HDR1 


* 


File B data 


* 


EOV1 


* 


* 




(B) 




Volume 
2 


VOL1 


HDR1 


* 


File B data / / 


* 


EOV1 


* 


# 




(B) (B) (C) 


(C) 


Volume 
3 


VOL1 


HDR1 




File B data // 


* 


EOF1 


* 


HDR1 


* 


File C data 


* 


EOF1 


* 


* 



Figure 1-2-2. Use of ANSI Labels 
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An ANSI-labeled tape must have the following labels. Other optional labels are described 
in appendix G. 

Location 



Label 

VOL1 
HDR1 

EOF1 
EOV1 



Beginning of volume 

Beginning of information (repeated on each volume containing all or part 

of the file) 

End of information 

End of volume (required only if the file continues on another volume) 



Appendix G gives the tape label formats. The use of ANSI labels to delimit files within file 
sets is illustrated in figure 1-2-2. 

Tape Data Formats 

NOS can read and write data on magnetic tape in any of the following formats. 

Format Mnemonic 



Internal (NOS default) 

System internal? 

Stranger 

Long block stranger 

Foreign 



I 

SI 

S 

L 

F 



These data formats differ in their PRU (block) size and in their record and file mark 
indicators (refer to table 1-2-1). Other format differences are: 

Noise 
Sizett 



Tape 
Format 


Labels 

Labeled or 
unlabeled 


Recording 
Mode 


I 


Binary only 


SI 


Labeled or 
unlabeled 


Binary only ft? 


S 


Labeled or 
unlabeled 


Binary or coded 


L 


Labeled or 
unlabeled 


Binary or coded 


F 


Unlabeled 
(labels 
read as 
data) 


7 -track: binary 

or coded; 

9 -track: binary 

only 



7-track: < 8 frames 
9- track: < 6 frames 

7-track: < 8 frames 
9-track: < 6 frames 

User-selected; 
default is < 18 frames 

User-selected; 
default is < 18 frames 

User- selected; 
default is < 18 frames 



NOS terminates blocks on I and SI format tapes with a 48-bit block (PRU) terminator. The 
terminator contains the total number of bytes in the block (including the terminator itself), 
the number of blocks since the last HDR1 label, and the level number of the block. This 
terminator enables read operations on I format tapes to check if the number of bytes read 
and the block number expected match the byte count and block number in the terminator. 



t NOS /BE system default tape format (binary mode only), 
tt Tape blocks read that are smaller than the noise size are discarded. An attempt to 
write a block smaller than the noise size produces an error message. 
Ttt Specification of coded mode results in job termination; refer to TCOPY statement in 
section 7. 
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If either does not match, the system attempts to recover the missing data. This feature 
prevents dropped or fragmented blocks and provides a higher degree of reliability than 
other data formats. 

Tapes should be read with the same format specified as when they were written. Data is 
then recovered in its original form. For some formats, NOS writes extra bits which are 
discarded when the tape is read. I format 9-track tapes are always written with an even 
multiple of bytes per block. SI format 9-track tapes may have an extra 4 bits written per 
block to preserve the lower 4 bits of a CM word. (A 60-bit CM word would be written in 
eight frames, 8 bits per frame.) 

All 9-track tapes are written with odd parity. Binary 7-track tapes have odd parity; coded 
7-track tapes have even parity. If a parity error is detected on an F format 7-track tape, 
the recording mode (binary or coded) is automatically switched. 

Appendix J of volume 2 describes tape formats in greater detail. 



FILE TYPES 

The following defines types of files assigned to user jobs and types of permanent files on 
mass storage. A file assigned to a job is known to the system by its entry in the file name 
table/file status table (FNT/FST). A FNT/FST ,entry contains the file name, the device on 
which the file resides, the file type, and its current position and status. 

A permanent mass storage file is known to the system by its entry in a permanent file 
catalog associated with a user number. The catalog entry contains the file's name, location, 
length, permission modes, and access history. 



FILES ASSIGNED TO USER JOBS 

NOS uses the following mnemonics for file classification. 



INFT 


Input file 


PMFT 


Direct access file 


PRFT 


Print file 


LIFT 


Library file 


PHFT 


Punch file 


ROFT 


Rollout file 


LOFT 


Local file 


TEFT 


Timed/ event rollout file 


PTFT 


Primary terminal file 







Input files, print files, punch files, rollout files, and timed/event rollout files are queued 
files. A queued file waits on mass storage until the system resource or peripheral equip- 
ment it requires becomes available and its priority is the highest of the files in the queue. 



Input Files 

An input file is also called a job file because it contains user- supplied control statements 
and data for a job (refer to section 3). Input files exist on mass storage in the input queue. 
A file enters the input queue directly when a local or remote batch job enters the system or 
indirectly when a user job submits another job via a SUBMIT, LDI, or ROUTE control 
statement. The input file of a time-sharing job consists of all terminal input directed to 
the system during a time- sharing session. Because the system processes the control state- 
ment immediately after it is read from the terminal, a time-sharing input file is always 
empty except when processing a procedure file. A user job refers to its input file by the 
file name INPUT (refer to Input File Control in section 3). 

1_2 " 8 60435400 J 



Print Files 

A print file contains data to be printed. It is created and placed in the print queue as a 
result of the following. 

• At job termination when the system changes the local file OUTPUT, if present, 
into a print file.t 

• At execution of an OUT, ROUTE, or DISPOSE control statement naming a local 
file to be printed. 

The local or remote batch subsystem processes the files in the print queue. By default, 
jobs originating at a central site card reader are routed to a line printer with the same ID. 
Similarly, remote batch output returns to the remote batch terminal where the job originated. 
Each remote batch terminal is given a unique terminal identification code (TID) when it logs 
in. Remote batch jobs and the print files they generate are given the TID of their originating 
terminal. 

Users can override the default routing of print files with the ROUTE statement (refer to 
section 7). The ROUTE statement can specify a printer or printer type. 

As a print file waits in the print queue, its priority increases. The file is printed when 
its printer becomes available and when its priority is higher than all other files destined 
for that printer. 

OUTPUT has no special internal format. The user may wish to add appropriate printer 
control characters (refer to Line Printer Carriage Control in appendix I). Appendix D 
contains the printer output from the compilation and execution of a sample program. 



Punch Files 

A punch file contains data to be punched on cards. A punch file is routed from the mass 
storage punch queue according to the name the user assigns it or according to parameters 
specified on a ROUTE or DISPOSE statement. The following are punch file names. 

PUNCH Contains Hollerith punch output. 

PUNCHB Contains binary punch output. 

P8 Contains 80-column absolute binary punch output. 

Punch files enter the punch queue at job completion or upon execution of an OUT, ROUTE, 
or DISPOSE control statement. The routing and scheduling procedures for punch files are 
the same as for print files. Punched card formats are described in appendix F. 



t Not applicable to time- sharing jobs. 
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Local Files 

Local files are temporary files. The local file type includes all scratch and working files 
except the primary file. 

The user can create a local file by: 

• Naming the file in a COPY control statement or in a read or write statement 
within a program. A local file created in this manner always resides on mass 
storage. 

• Naming the file in an ASSIGN or REQUEST control statement assigning the local 
file to mass storage or to a time-sharing terminal or in an ASSIGN, LABEL, or 
REQUEST control statement assigning the local file to magnetic tape. 

• Naming the file in a GET control statement generating a local mass storage file. 

To save the contents of a local mass storage file, the user issues a SAVE or REPLACE 
control statement to copy the local file to a permanent indirect access file. Data written 
on a local file assigned to magnetic tape is written on the tape for later access. Local 
files are released upon job completion. 



Primary Files 

The primary file is a temporary file designated as the primary file by a PRIMARY, NEW, 
or OLD control statement. Only one primary file is allowed at a time. Some control 
statements use the primary file as the default file when a file name is not specified. NOS 
rewinds the primary file before each job step. 



Direct Access Files 

A user assigns a direct access permanent file to his job by issuing an ATTACH or DEFINE 
control statement. When the user attaches the file in a mode permitting file modification, 
he can write on the permanent file. Refer to Permanent Files in this section. 



Library Files 

A library file is a read-only file that several users can access simultaneously. This file 
type should not be confused with system library programs or with public permanent files 
stored under user number LIBRARY. Refer to Libraries in this section for a description 
of the uses of the term library in NOS. 

A user must be validated to access or create a library file. The validated user can create 
a library file as follows: 

1, Create a local file with file name ifn. 

2. Enter the following control statements. 

LOCK(lfn) 
COMMON (lfn) 
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The validated user can read a library file after naming it in a COMMON control statement. 

A library file cannot be removed from the system once it has been created except by a 
deadstart. Library files are not retained on initial (level 0) deadstart. They are retained 
on level 1 or 2 deadstart if a system checkpoint was done after their creation. They are 
always retained after a level 3 deadstart. 



Rollout Files 

If, during job processing, the system or the user determines that a job must be temporarily 
removed from central memory, the system writes all information concerning the job on a 
system- defined rollout file. The rollout file includes the contents of the CM field length 
and the ECS field length of the job and the job- related system information from CMR. The 
file is read back into CM (and ECS) when the job is again assigned to a control point (refer 
to Rollout Control in section 3). 



Timed/Event Rollout Files 

A timed/event rollout file is similar to a rollout file in that it contains all the information 
concerning a job temporarily removed from central memory. However, a timed/event 
rollout file is rolled back into central memory only when a specified event has occurred 
(such as a file no longer busy) or a specified time period has elapsed. 

A job may be written on a timed/event rollout file as a result of system or user action. 
The system uses a timed/event file if a job issues file or device requests that cannot be 
immediately honored. Users place their jobs on a timed/event rollout file when they use 
the ROLLOUT control statement to roll out their jobs for a specified time period. 



PERMANENT FILES 

Permanent files are retained on mass storage until their creator purges them. There are 
two types of permanent files, indirect access permanent files and direct access permanent 
files. 

Each permanent file is listed in a permanent file catalog associated with a user number. 
Each permanent file catalog lists all permanent files created under that user number and 
their location on mass storage. Unless an alternate user number is specified, the system 
assumes all permanent file requests are made to this catalog. 

User numbers (refer to Validation in section 3) that contain asterisks represent users with 
automatic read-only permission to files in the catalogs of other users. The user number 
must match the alternate user number in all characters not containing asterisks. For 
example, the user with user number *AB*DE* can access the catalogs of the following users. 

UABCDEF 
UABDDEE 
MABCDE1 
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Indirect Access Permanent Files 

Indirect access permanent files are accessed by copying the permanent file to a temporary 
file (local or primary file type). The user creates an indirect access permanent file by 
naming a temporary file in a SAVE or REPLACE control statement. He can retrieve a 
temporary copy of an indirect access file by naming it in an OLD or GET control statement. 
To alter the indirect access file, he enters a REPLACE statement naming the temporary 
copy. The system then writes the temporary copy over the permanent copy of the indirect 
access file. 

Mass storage for indirect access permanent files is allocated in 640-character blocks (64 
CM words). Because of its small allocation block size and the disk space required to 
maintain a working copy, indirect files are usually relatively small files. 

The maximum size of an indirect access file is determined either by the value of the FS 
validation parameter described in the LIMITS control statement in section 6, or if no FS 
restriction is imposed, by the device limitations described in Mass Storage Files in this 
section. 



Direct Access Permanent Files 

The user accesses a direct access permanent file directly, not through a temporary copy. 
The user creates a direct access permanent file with a DEFINE control statement. He 
accesses the file with an ATTACH control statement. If he wants to alter the file, he must 
attach it in modify, append, or write mode. Only one user at a time can attach the file in 
write mode; this feature is called the write interlock. Data is written directly on the 
permanent file. 

Mass storage for direct access permanent files is allocated in large blocks; the block size 
depends on the mass storage device type on which the file resides (refer to Mass Storage 
Files in this section). Because of their large allocation block size and the write interlock 
feature, direct access files are often used for database files. 

The maximum size of a direct access file is determined by the DS validation parameter 
described in the LIMITS control statement in section 6, or if no DS restriction is imposed, 
by the device limitations described in Mass Storage Files in this section. 



MASS STORAGE FILE RESIDENCE 

For most mass storage file operations, the user need not be concerned about the specific 
device on which his file resides. However, under certain circumstances, the user may 
wish to override the default device residence for local or permanent files. 

With the ASSIGN control statement, any user who has the necessary validation can assign 
a local file to either a specific device or to a device category. 

Every permanent file the user creates resides either in his family of permanent file 
devices or on an auxiliary device. Unless the user specifies otherwise, all permanent files 
are saved in his family. 
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FAMILY DEVICES 

A family consists of 1 through 63 mass storage devices. Within a family, each user has 
a master device that contains his permanent file catalog, all his indirect access files, and 
may contain some or all of his direct access files. 

Normally a system has only one family of permanent file- devices. However, because 
families are interchangeable between NOS systems, several families may be active on one 
system, or a system may be part of a multimainframe system. For example, consider ati 
installation with two systems, A and B. System A provides backup service to system B. 
If system A failed, its family of permanent file devices could be introduced into system B 
without interrupting current operations on system B. 

The user identifies his family by supplying a 1- to 7-character family name. The family 
name is included on the USER statement in batch jobs and is entered during login in time- 
sharing jobs. If only one family is active or if another family has been introduced into the 
user's normal system, he may, but need not, supply his family name. When the family 
name is omitted, the system uses the system default family name. If the user's family has 
been introduced into another system, he must supply his family name. 

If the user chooses to save his files on family devices, he has the option of either using 
the system default device type or specifying another type of permanent file device. 



AUXILIARY DEVICES 

An auxiliary device is a supplement to the mass storage provided by family devices. It is 
identified by a 1- to 7-character pack name. An auxiliary device is not necessarily a disk 
pack that can be physically removed as the pack name implies. Rather, an auxiliary device 
can be any mass storage device supported by the system and defined as such by the 
installation. Each auxiliary device is a self-contained permanent file device; ail direct 
and indirect access files represented by the catalogs on the device reside on the device. 
Auxiliary devices may be defined as public or private. Anyone permitted to use auxiliary 
devices who supplies the appropriate pack name can create, replace, and access files on a 
public device. Only one user, the owner, can create and replace files on a private auxiliary 
device, but others may access those files as permitted by the owner. 



LIBRARIES 

As defined in the glossary (appendix C), the term library has several meanings. The 
applicable meaning for the term must be determined from its context. The following 
describes some NOS libraries. 



USER NUMBER LIBRARY 

Files stored under user number LIBRARY need not be libraries themselves. An installa- 
tion saves programs or text as files under user number LIBRARY so that validated users 
can access them. Users access those files by specifying the file name and the alternate 
user number LIBRARY on their permanent file request or by issuing the LIBRARY time- 
sharing command (refer to the IAF Reference Manual or the Time-Sharing User's Reference 
Manual). 
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PROGRAM LIBRARIES 

A program library is a collection of source deck images stored in compressed Modify or 
Update format. The validated user accesses these-compressed source decks through 
MODIFY or UPDATE control statements (refer to section 13). 



USER LIBRARIES 

User libraries are the files named in the LIBRARY loader control statement and searched by 
CYBER Loader to satisfy external references within the program it is loading. They 
contain compiled or assembled routines. The first record of a user library is a ULIB 
record; the last record is an OPLD directory record (refer to the LIBGEN statement in 
section 14). 

User libraries are generated by the user, the product, or the system. CYBER Loader first 
searches the user-generated libraries specified by a LIBRARY or LDSET control statement 

(refer to the CVRF!R T.naHpr R(»fprpnr>p Manna It nvaVB T no^or +h^^ o,«>«..„i,„„ *«,„ i.._j. 

— — -■ — " — — *>*—"——*/ - w j. j-ij-m*.\ uwuuk.i b..4V»Ll OliCIl U11CO (.-L1C Ji UUUL I 

set library (such as the FORTRAN Extended library) stored on the system library. Finally, 
CYBER Loader searches the system default user library SYSLIB, which is also on the 
system library. 

Section 14 describes control statements that catalog and manipulate library records. 
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JOB FLOW AND EXECUTION 



A job is a file of statement images, t Its first record contains control statements that 
specify job processing requirements. Every job begins with a job statement and a USER' 
statement. The end of the control statement record is marked by an EOR. 

Records that follow the control statement record contain program, data, or directive 
input for processing control statements. The user can consider the job file as two files, 
entered as one but processed concurrently. As each control statement requiring additional 
user input is processed, the system reads the next record in the input file (unless the 
control statement specifies otherwise). These following records must be in the same 
order as the control statements that use them. 

For example, figure 1-3-1 illustrates a basic job deck. The first three control statements 
are processed by system routines that require no additional user input. The fourth control 
statement, FTN(GO), requests two job steps, the compilation of a FORTRAN Extended 
program and its execution. Because the I parameter is omitted from the statement, the 
system reads the next record of the input file, expecting it to be a FORTRAN source pro- 
gram. After successful compilation, the system executes the program, taking input data 
from the third record of the input file. Normal job termination occurs when the system 
reads the control statement record EOR (the first 7/8/9 card). 



JOB INITIATION 

The user initiates jobs by: 

• Reading a card deck in through a local or remote batch reader. 

• Logging into a time-sharing terminal. 

• Entering a job via an LDI, ROUTE, or SUBMIT control statement within a job 
already in the system. 



t A time- sharing job consists of all input entered during a time- sharing session (refer to 
the IAF Reference Manual or the Time-Sharing User's Reference Manual). 
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DATA DECK 



SOURCE DECK 



Figure 1-3-1. FORTRAN Compile and Execute Deck 



JOB ORIGIN TYPES 

When a job enters the system, the system determines the job origin type according to the 
means used for job initiation. Its origin identification remains with the job throughout job 
processing. The job origin type determines how the job is handled and how it exits from 
the system. 

Jobs originating from the system console are assigned system origin type (SYOT). Jobs 
entered through the time-sharing executive or the Interactive Facility (IAF) are assigned 
time-sharing origin type (TXOT). Jobs entered through a local batch card reader are batch 
origin type (BCOT) jobs. Jobs entered through Export/Import or the Remote Batch 
Facility (RBF) are remote batch origin (EIOT) jobs. 
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If validated, a user can initiate jobs using the LDI, ROUTE, or SUBMIT control statements. 
Jobs initiated by ROUTE or SUBMIT statements can be either batch origin or remote 
origin jobs depending on the statement parameters. Jobs initiated by LDI statements are 
batch origin jobs. 



JOB NAMES 

After entering the system, the job is assigned a unique job name to prevent job name 
duplication within the system. This name is not the job name specified on the job statement. 
The first 7 characters of the job identification are the system- assigned job name; the 
eighth character indicates the job origin type. This job name precedes all messages issued 
to the system dayfile for that job. These messages include normal operating messages, 
error messages, and accounting information issued by the system. 



SYSTEM ORIGIN TYPE (SYOT) JOB NAME FORMAT 

The first 4 characters of a system job name are obtained from the job name entered or are 
zero-filled if fewer than 4 characters are entered. The next 3 characters are a unique 
system sequence number in the range from AAA to 999. The eighth character is an S. For 
example, if the job entered is DIS, a possible job name is DISOAABS. 



BATCH ORIGIN TYPE (BCOT) JOB NAME FORMAT 

The first 4 characters of a batch origin job name are generated from the user index 
associated with the user number supplied on the USER control statement. These 4 charac- 
ters are unique to the user. The next 3 characters are the job sequence number. The 
eighth character of a batch origin job name is B. 



TIME-SHARING AND REMOTE BATCH {TXOT AND EIOT) JOB NAME FORMAT 

The first 4 characters of these job names are generated from the user index associated 
with the user number supplied by the user when logging into the system. The next 3 charac- 
ters represent the number of the terminal on which the user is logged in for TXOT or the 
system sequence number for EIOT. The eighth character is T for time-sharing origin 
jobs and E for remote batch jobs. 

All jobs entered via a SUBMIT or ROUTE control statement derive the first 4 characters 
of their job names from the job's current user index in the same manner as EIOT and 
TXOT jobs. The last 3 characters are the system sequence number with the eighth charac- 
ter being either E or B, as described previously, depending on the parameters supplied 
with the SUBMIT or ROUTE statement. 
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VALIDATION 

The USER statement follows the job statement and is used to validate the user as a legal 
user (refer to USER statement in section 6). If the user is validated, a set of control 
values is set in the control point area; these values are used by the system to control all 
system requests. In most cases, if the user is not permitted to perform specific functions 
(such as access nonallocatable devices), his job is aborted and the message 

ILLEGAL USER ACCESS. 

is issued when the illegal function is attempted. 

To determine the extent of his validation, the user can issue the LIMITS command and 
receive a listing of his current validation control values. Refer to the LIMITS control 
statement in section 6 for an explanation of these values. For further information or 
to change his validation, the user should contact installation personnel. 

Each user number has a unique user index associated with it. Once a user number is 
validated, the user index is set in the control point area. The system uses this index to 
determine the location of the user's permanent file catalog. (Refer to the NOS System 
Maintenance Reference Manual for an explanation of the user index. ) 



ACCOUNTING 

The unit of accounting for the system is the system resource unit (SRU). The SRU is a 
composite value of central processor time, I/O activity, and memory usage. SRU 
operations are initiated at the beginning of a job and reinitiated whenever another CHARGE 
control statement is encountered. SRU information includes: 

Central processor time. 

Mass storage activity. 

Magnetic tape activity. 

Permanent file activity. 

SRU value. 

Application account charges. t 

This information is written to the user's dayfile at the end of the job or whenever a CHARGE 
statement is processed. The user may request SRU information to be written to his output 
file at any time during the job by issuing the ENQUIRE or SUMMARY control statement. 
The format of SRU information written in the dayfile is given under Job Completion in this 
section. 



f Not currently supported by the system but reserved for future use. 
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JOB SCHEDULING 

When a job enters the system, it is placed in the input queue on mass storage, where it 
waits for the required system resources to become available. The job is assigned an input 
queue priority depending on its origin. The system priorities are system-defined and can 
be altered only by the system operator. The job queue priority is advanced as the job waits 
in the queue. The priority ages to a system-defined limit. The job scheduler periodically 
scans the queues and active jobs to determine whether action is necessary to ensure that 
the highest priority jobs are being serviced. This action may include rolling out low priority 
jobs or rolling in higher priority jobs. The job scheduler is also activated to analyze the 
system status whenver the status of the system changes (for example, when the field 
length of a job is released, a job enters a queue, or a job completes). Because of this 
automatic scheduling and analysis of system status changes, a user can increase system 
performance by releasing memory when ail the assigned memory is not required. 

Once a job is brought to a control point, normal control statement processing begins. The 
general flow of the control statement processing is illustrated in figure 1-5-1. 



JOB CONTROL 

While a job is at the control point, the system exercises the following controls over the job. 

FIELD LENGTH CONTROL 

The system controls the field length assigned to a job, adjusting it according to the require- 
ments of each job step. A programmer can influence the field length assigned to his job 
by using the central memory job statement parameter (refer to section 5) and the MFL 
and RFL control statements (refer to section 6). 

The maximum field length for a job (MAXFL) is set at the smallest of the following values. 

• Central memory job statement parameter value, if specified. 

• Maximum field length for which the user is validated.- 

• Maximum field length available for user jobs (dependent on machine size). 

The maximum field length for each subsequent job step (MFL) is initially set equal to MAXFL. 
It can be reset, however, by MFL control statements. MFL cannot exceed MAXFL. 

The running field length (EFL) is initially set to zero, indicating system control of field 
length. The RFL control statement resets RFL. RFL cannot exceed the current MFL. 

To set the initial field length for a job step, the system uses the first value set by one of 
the following. 

• Predefined initial field length for a system routine (RFL= or MFL= special entry 
point as described in appendix F, volume 2). 

• Highest high address (HHA) from EACP loader table (54 table). Refer to the 
CYBER Loader Reference Manual. 

• RFL value, if nonzero. 
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• The smaller of the MFL or the. installation-defined default value (release value 
oUUUUJS) « 

CYBER Loader further adjusts the field length during program loading. Memory may be 
added or removed as the needs of the program change. Refer to the description of the 
REDUCE control statement in the CYBER Loader Reference Manual. 

The following example shows a control statement record, the MAXFL, MFL, and RFL 
settings, and the actual field length used to process the statement. 



Control Statement 

JOB(CM60000) 
USERUJSERABC, 123. FAM1) 
CHARGE(4922, 66X) 



MAXFL MFL RFL 



60 000 
60 000 
60 000 



RFL(40000) 



ABSPROG. 



60 000 
60 000 
60 000 









Field 
Length 

700 

700 

2200 



GET(ABSPROG,RELPROG) 60 000 60 000 



60 000 60 000 



1700 



1500 



60 000 60 000 40 000 40 000 



Explanation 

The CM parameter 
sets the MAXFL and 
MFL values. The sys- 
tem sets the field 

I****-**!. « ~ _»_>«.; i * 

j.ciigt,xi as ic^uucu iyr 

processing the control 
statements. 

GET statement re- 
trieves copies of an 
absolute program and 
a relocatable program. 

The user issues an 
RFL statement to set 
the field length for 
execution of the abso- 
lute program that 
follows. 

The absolute program 
on file ABSPROG is 
executed within a 
40 000-word field 
length. 



MFL(50000) 



60 000 60 000 40 000 1500 



RELPROG. 



60 000 50 000 



The user issues an 
MFL statement to set 
the m a ximu m field 
length for the following 
relocatable load. 



<50 000 if more than 50 000 

words is required, the 
job aborts. 



I 
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INPUT FILE CONTROL 

All user jobs, when initiated, have a file named INPUT. This file contains the control 
statements and other input records required for job execution. (INPUT is a locked file. ) 
As a result, the user may read from it and reposition it, but the system does not allow him 
to write on it. If for some special reason the user needs to write on INPUT, he should 
first issue a RETURN (INPUT) control statement (refer to section 7). This statement 
changes the name of the file from INPUT to INPUT* and leaves it assigned to the user's job. 
The change of name on RETURN applies only if the input file is of type INFT. 



TIME LIMIT CONTROL 

The system sets a time limit for each job step unless the job statement or the SETTL 
statement specifies a job step time limit. This time limit is the amount of central processorj 
time that any one job step is allowed. The user cannot increase the limit beyond that for 
which he is validated. 

While a job is using the central processor, the time of usage is accumulated and checked 
against the time limit for each job step. If the job is not a time-sharing (TXOT) job, the 
job in execution is aborted when the time limit is reached. Time-sharing origin jobs are 
rolled out, after which the user can increment the time limit and resume execution from 
the point where the time limit was exceeded. Refer to the IAF Reference Manual or the 
Time-Sharing User's Reference Manual for more details. 



SRU LIMIT CONTROL 

The system sets a limit on the number of system resource units (SRU) that a job step or an 
account block can accumulate. An SRU includes central processor time, central memory 
usage, permanent file activity, and mass storage and tape I/O. An account block is that 
portion of a job from one CHARGE statement to the end of the job or the appearance of 
another CHARGE statement. The user may alter these limits through the SETJSL and 
SETASL control statements or macros; however, he may not set either limit beyond that 
for which he is validated. 

While a job is in the system, SRU usage is accumulated and checked against the SRU step 
and account block limits. If the job is not a time-sharing job (TXOT), the job is aborted 
when either limit is reached. Time- sharing jobs are rolled out. After a time- sharing job 
is rolled out, the user can increment the limit and resume execution from the point where 
the limit was reached. Refer to the IAF Reference Manual or the Time-Sharing User's 
Reference Manual for more details. 
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CONTROL STATEMENT LIMIT CONTROL 

If a job executes more control statements than the number for which the user is validated, 
the following message is issued when the limit is reached by job processing. 

INITIAL CONTHOL STATEMENT LIMIT. 

The job is then allowed eight additional control statements for error processing such as 
saving and dumping of files. When this limit of eight statements is exceeded, the job is 
terminated with the following message. 

CONTROL STATEMENT LIMIT. 

A user's control statement limit is given by the CC field in the output from the LIMIT con- 
trol statement (refer to section 6). 



ROLLOUT CONTROL 

Each executing program is allowed to reside in CM for a certain amount of time before 
relinquishing its space to another program. When this CM time slice is exceeded, the 
program may be rolled out. This means that the contents of the job field length, the job 
control area, and the control registers (exchange package) are written to mass storage. 
The program remains on mass storage until it is rolled back into memory. Execution re- 
sumes from the point where rollout occurred. The amount of time the job is allowed to 
"occupy CM is called the central memory time slice. The central memory time slice is a 
system parameter that can be changed only by the system operator. The time slices vary 
for each origin type. Whether a job is rolled out when its time slice expires depends on 
several factors. 

• Whether there are jobs waiting in the input and rollout queues. 

• Whether the jobs that are waiting have a lower priority. 

• Whether jobs that are waiting require more field length than would be available 
if all jobs of lower priority were rolled out. 

i 

When a job is rolled out, it is assigned a queue priority. The priority assigned is a system 
parameter and can be changed only by the system operator. The queue priorities can vary 
for each origin type. The queue priority is aged (incremented) while the job is in the rollout 
queue. Normally,^ all other factors being equal, the job with the highest queue priority is 
selected to be rolled in. 
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ERROR CONTROL 

When job step activity ceases, the system must determine the next control statement to 
process. If activity ceased due to normal termination, the next control statement processed 
is the next statement in sequence. If an error caused activity to cease, the system issues 
the appropriate dayfile message and exits from the job. 

Errors may be detected by system software or hardware. When the system hardware detects 
an error condition, NOS issues two or more dayfile messages. The first message gives the 
address where the error was detected. The second and following messages give the types of 
errors that occurred. NOS then dumps the exchange package for the job to OUTPUT (for 
batch origin jobs) or to the mass storage file ZZZDUMP (for time-sharing jobs) (refer to 
section 12). 

After issuing the appropriate dayfile message(s), the system searches for an EXIT control 
statement. If an EXIT statement is found, processing continues with the statement following 
EXIT. If, before detecting the error, the system encounters a NOEXIT statement, it makes 
no search for an EXIT statement, and processing continues with the next control statement. 
If neither an EXIT nor a NOEXIT statement is encountered, the system terminates the job. 
(Exit processing is further described in section 5.) 

The user can specify the error exit mode on which the system is to abort with the MODE 
statement so that address or operand out of range and/or indefinite operand errors are 
allowed and program execution continues (refer to section 6). The default error exit mode 
specifies that all errors terminate the job. 

Volume 2 describes the EREXIT and MODE macros that can be used to control exit pro- 
cessing in COMPASS programs. Section 12 of volume 2 specifies file completion procedures 
when a job step abort occurs. 

SECURITY CONTROL 

Unless the job is system origin type or the user is validated for system origin privileges 
and DEBUG mode has been set at the system display console, system security imposes 
the following restrictions on control statements which dump any portion of the field length 
of the previous job step. 

• They may not follow the execution of certain protected system programs (refer 
to section 1, volume 2, for further definition). 

• They may not follow user programs which have requested protection (refer to 
the description of the SETSSM macro, section 6, volume 2). 
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If the user violates these restrictions, the system issues an informative message to the 
dayfile and ignores the control statement. 

The following are the restricted control statements. 



CATALOG 


COPYCF 


DMD 


LBC 


RESTART 


CKP 


COPYCR 


DMDECS 


LIBEDIT 


TCOPY 


COPY 


COPYEI 


DMP 


LOC 


VERIFY 


COPYBF 


COPYSBF 


DMPECS 


PBC 


VFYLIB 


COPYBR 


COPYX 


EDIT 


RBR 


WBR 



CCL statements are also restricted (refer to section 4). 

JOB COMPLETION 

When there is no more activity at a control point, no outstanding central processor requests, 
and no control statements to process, the job is completed in the following manner. 

1. All CM assigned to the job is returned to the system. 

2. ECS assigned to the job is released. 

3. All equipment assigned to the job is returned to the system. 

4. All library files attached to the job are returned; other jobs can then access them. 

5. All scratch (local) file space used by the job is released. 

6. All direct access permanent files attached to the job are returned; the status 
information for these files is updated. 

7. The following summations of job activity are added to the end of the user's day- 
file. ThLS information is also issued to the associated account dayfile The 
entries in the account dayfile also include the job name. 

• Application charge activity in kilounits: 

hh. mm. ss . UEAD, xxxxxx. xxxKUNS. 

• Permanent file activity in kilounits: 

hh. mm. ss . UEPF, xxxxxx. xxxKUNS. 

• Mass storage activity in kilounits: 

hh. mm. ss. UEMS, xxxxxx. xxxKUNS. 

• Magnetic tape activity in kilounits: 

hh.mm. ss.UEMT, xxxxxx. xxxKUNS. 
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• Accumulated central processor time in seconds :t 

hh. mm. ss.UECP, xxxxxx. xxxSECS. 

• SRU value in units for total job usage including CPU time, I/O activity, and 
memory usage: 

hh. mm. ss.AESR, xxxxxx. xxxUNTS. 

• Lines printed in kilolines: 

hh. mm. ss. UCLP.mies, xxxxxx. xxxKLNS. 

mi Machine ID 

es EST ordinal of the output device 

• Cards read in kilocards: 

hh. mm. ss. jobname. UCCR. mies. xxxxxx. xxxKCDS. 

The following information is issued to the account dayf ile only. 

• Cards punched in kilocards: 

hh. mm. ss. jobname. UCPC. mies. xxxxxx. xxxKCDS. 

8. Control point dayfile is copied to the end of the OUTPUT file. If an OUTPUT file 
does not exist or if it is a deferred routed file with EC=A9 specified, the dayfile 
is copied to another print file. 

9. All print and punch files are released to the print and punch queues. 
10. The control point area is cleared for the next job. 



t If the installation defines a CPU multiplier value, the value given is the product of the 
actual CPU seconds and the multiplier. 
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CDC CYBER CONTROL LANGUAGE 



INTRODUCTION 

The CYBER Control Language (CCL) is a set of statements that the user can insert in 
the control statement record of a job to initiate tests, transfers, and loops -within that 
record. CCL also enables the user to set values to symbolic names, display results in 
the dayfile of the job, and interrogate the system to determine the status of files. CCL 
also enables a user to create and reference procedure files which contain sequences of 
control statements and/or control language statements. 

Another system control language is also available but users are encouraged to use CCL 
(refer to appendix H). 

The following paragraphs describe the elements of CCL. This is followed by a descrip- 
tion of CCL expressions. The remainder of the section describes CCL statements, 
functions, and procedures. 

The following CCL statements are used to skip or conditionally process a sequence of 
statements. 



Statement 



Description 



1FE 



Passes to the next statement if an expression associated with IFE 
is true; skips until a terminating CCL statement is found, if it is 
false. 



SKIP 

ELSE 



Skips until a terminating CCL statement is found. 

Either terminates or initiates skipping, depending upon other CCL 
statements employed. 



ENDIF 



Terminates skipping initiated by IFE, SKIP, or ELSE. 



The following CCL statements identify a sequence of control statements as a loop that 
can be repeatedly processed. 

Statement Description 

WHILE Establishes the beginning of the loop. If the associated expression 

is true, the loop is processed; if it is false, the loop is not 
processed. 



ENDW 



Establishes the end of the looo. 
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The following CCL statements assign and display values associated with symbolic names. 
Statement Description 

Allows the user to assign values to special CCL registers. 



SET 
DISPLAY 



Evaluates an expression and displays the result in the dayfile of 
the job. 



CCL provides the following functions to be used with expressions. 



Function 

FILE 

DT 

NUM 
SS 



Description 
Determines the attributes of a file. 

Determines the type of device on which a file resides. 
Determines if a parameter has a numeric value. 
Determines the subsystem in use. 



The following CCL statements enable the user to define and control processing of a 
control statement procedure. 

Statement Description 

BEGIN Initiates processing of a procedure. 

REVERT Returns processing from a procedure to the control statement 

record that called it. 

The following CCL commands identify statements requiring special processing. 

Command Description 

Precedes and identifies a procedure. 

Precedes a sequence of statements to be written to another file. 



PROC 

DATA 
EOR 



Separates records within the statement sequence to be written to 
another file. 

. EOF Separates files within the statement sequence to be written to 

another file. 

. * Prefixes a comment line. 

Ail CCL statements must be terminated. Within a statement, an expression or function may 
end in a right parenthesis. If this occurs at the end of the statement, the right parenthesis 
does not serve as the statement terminator; an additional terminator must be included to 
complete the statement. 
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EXPRESSIONS 

A CCL expression consists of operators and operands. Expressions can be nested 
within expressions by means of parentheses; however, parentheses do not imply multi- 
plication. Operators can be arithmetic, relational, or logical. Operands can be any 
of the following. 

Operand Description 

Integer constant A string of 1 to 10 characters. If the string is to be a UteraL, 
it must be delimited by dollar signs ($xxxxxxxxxx$). 

Symbolic name An alphanumeric character string of 1 to 10 characters. It has 

a numeric value. This value Is either an installation-defined 
constant or a user- or CCL-defined variable. 

CCL function A CCL-defined operand which determines attributes of a file or 

symbolic name. 

Expression A CCL expression enclosed with separators. This expression 

is evaluated, and the result is the operand. 

An expression can be as long as the user wishes; however, there must be a period or a 
closing parenthesis within the first 50 operands. 

Any character string beginning with a numeric character is treated as numeric. This string 
cannot contain any nonnumeric character except an optional postradix B (octal) or D 
(decimal). An alphanumeric string must begin with an alphabetic character. 

CCL expressions can be used with the CCL statements IFE, WHILE, DISPLAY, and SET 
and with the FILE function. The separator preceding the expression can be a comma or 
left parenthesis. The separator following the expression must be a comma. 

Integer arithmetic is used in each step of the evaluation of a CCL expression. Division, 
multiplication, and exponentiation produce a zero result if the absolute value exceeds 

* — 1. 



OPERATORS 

ARITHMETIC OPERATORS 

The following are the CCL arithmetic operators. 



+ 


Addition 


- 


Subtraction 


* 


Multiplication 


/ 


Division 


*T 


Exponentiation 


Leading - 


Negation 


Leading + 


Ignored 
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RELATIONAL OPERATORS 



A relational operator produces a value of one If the relationship is true and zero if it 
is false. The following are the CCL relational operators (either form may be used). 

= .EQ. Equal to 

.NE. Not equal to 

< . LT. Less than 

> .GT. Greater than 

. LE. Less than or equal to 

. GE. Greater than or equal to 

LOGICAL OPERATORS 

When a CCL expression contains a logical operator, CCL evaluates the full 60 bits of 
each operand and produces a 60-bit result. If the result has any bits set, it is true; 
if no bit is set, the result is false. The following are the CCL logical operators. 



-EQV. 


Equivalence 


.OR. 


Inclusive OR 


.AND. 


AND 


• XOR. 


Exclusive OR 


.NOT. 


Complement 



ORDER OF EVALUATION 

The order in which operators in an expression are evaluated is: 

1. Exponentiation 

2. Multiplication, division 

3. Addition, subtraction, negation 

4. Relations 

5. Complement 

6. AND 

7. Inclusive OR 

8. Exclusive OR, equivalence 
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OPERANDS 



INTEGER CONSTANTS 

An integer constant is usually a whole number (a numeric value without a fractional 
component) but may be a literal (a $-delimited character string). If it is numeric, it must 
be 10 characters or less including an optional postradix. If no postradix is included, 
decimal is assumed. If an integer constant is a literal, it must be 10 characters or less, 
excluding the $ delimiters. If CCL encounters a literal, it is right-justified in display code | 
and processed as a whole number. 



SYMBOLIC NAMES 

A symbolic name is an alphanumeric string to which a numeric value can be assigned. 
This numeric value may be defined at installation time or may be a variable set by the 
user or by CCL. All variables, except those for OT (job origin types), SYS (host 
operating system), VER (version of the operating system), and TIME (current time of day), 
have an initial value of zero. 

Symbolic names with special attributes are listed in table 1-4-1. 
These attributes are defined as follows: 

Attribute Description 

Local An X in this column of the table indicates that tue vawc is saved by a 

BEGIN statement before initiating a procedure and restored by a 
REVERT statement upon termination of a procedure. (Procedures are 
explained later in this section. ) 

Set An entry in this column specifies how the symbol obtains its value. One 

or more of the following characters may be listed in this column for 
each symbolic name. 



Character 


Description 


B 


Set by BEGIN. 


O 


Set by the operating system. 


R 


Set by REVERT. 



U Set by the user with the SET control statement or the 

SETJCI macro (refer to section 6 in volume 2). 

Compare The entries in this column are symbolic names with fixed values re- 

ferring to errors or job status. These fixed values are compared with 
the symbolic names in the NAME column via a CCL statement. This 
produces a true or false result. 

Example: 

If BCO in the NAME column is equivalenced to OT in the COMPARE 
column with the CCL statement 

IFE, BCO=OT, JUMP. 

and the job is local batch, the BCO=OT expression is true and control 
passes to the next statement. (IFE is explained later in this section. ) 
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TABLE 1-4-1. SYMBOLIC NAMES WITH ARITHMETIC VALUES 



Name 


Local 


Set 


Compare 


Description 


Rl 


X 


U 




Contents, control register 1 


R2 


X 


U 




Contents, control register 2 


R3 


X 


U 




Contents, control register 3 


RIG 




U 




Contents, global control register 1 


EM 




U 




Current exit mode (user sets with MODE 
statement) 


FL 




o 




Current CM field length 


MFL 




o 




Maximum CM field length 


MFLL 




o 




Maximum ECS field length 


CMN 




o 




Last running CM field length divided by 
100g (refer to RFL control statement 
in section 6) 










ECN 




o 




by IOOjj (refer to RFL control statement 
in section 6) 










PNL 




B, R 




Procedure nesting level: 

Original control statements 

1 Processing first level procedure 

50 Processing 50th level procedure 


DSC 


X 


u,o 




Dayfile skipped control statement flag 


EF 


X 


u.o 




Previous error flag 


EFG 




U,R 




Global error flag 


TLE 






EF 


Time limit error 


ARE 






EF 


Arithmetic error 


PPE 






EF 


PPU abort 


CPE 






EF 


CPU abort 


MNE 






EF 


Monitor call error 


ODE 






EF 


Operator drop 


PSE 






EF 


Program stop error 


FLE 






EF 


File limit error 


ECE 






EF 


ECS parity error 


TKE 






EF 


Track limit 


MSE 






EF 


Equivalent to track limit 


PEE 






EF 


CPU parity error exit 


SYE 






EF 


System abort 


FSE 






EF 


Forced error 


ORE 






EF 


Override error 


SSE 






EF 


Subsystem abort error 


SRE 






EF 


SRU limit error 


RRE 






EF 


Rerun error 


OKE 






EF 


Operator kill drop 


OT 




o 




Job origin type 


SYO 






OT 


System origin 


BCO 






OT 


Local batch origin 


EIO 






OT 


Remote batch origin 


TXO 






OT 


Time- sharing origin 


SYS 




o 




Host operating system 


NOS 






SYS 


NOS operating system 


VER 




o 




Version of the operating system. This 
is a numeric value which varies with 
different systems 


TIME 




o 




Current time of day (hhmm) 
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The symbolic names with true or false values are: 

TRUE = 1 

T = TRUE = 1 

FALSE= 

F = FALSE = 

SWn = sense switch, n = 1 to 6 

These symbolic names with true or false values, and the symbolic names in table 1-4-1 
are valid in any CCL expression. They are not valid within FILE or DT functions. 
The FILE and DT functions have their own file function symbolic names. 

CONDITIONAL STATEMENTS 

The CCL conditional statements initiate conditional or unconditional skipping of statements 
in the control statement record of a job. There are four conditional statements: SKIP, 
ENDIF, IFE, and ELSE. 

All conditional statements have a label string. This label string matches the statement 

that initiates the skip with a terminating statement that ends the skip. The terminating state-! 

ment must be in the same procedure as its initiating statement. I 

By default, skipped control statements are not written in the dayfiie of the job. The SET 
statement (explained later in this section) can change this default and cause skipped state- 
ments to be written in the dayfiie. 

SKIP STATEMENT 

The SKIP statement initiates an unconditional skipping of a sequence of statements that 
follow the SKIP statement. Control resumes with an ENDIF terminating statement that 
has a label string matching the label string specified on the SKIP statement. Only an 
ENDIF statement can serve as a terminating statement for a SKIP statement. 

The format of a SKIP statement is: 

SKIP, Is. 

Is Label string; 1 to 10 alphanumeric characters beginning with an 

alphabetic character. 

An example of the use of the SKIP statement is given after the description of the 
ENDIF statement which follows. 
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ENOIF STATEMENT 

The ENDIF statement terminates a skip initiated by a SKIP, IFE, or ELSE statement. 
In all cases, the label string on the ENDIF statement must match the label string on 
the statement that initiates the skip. If CCL encounters an ENDIF statement with a non- 
matching label string, it ignores that statement. 

The format of the ENDIF statement is: 

ENDIF, Is. 

Is Label string; 1 to 10 alphanumeric characters beginning with an alphabetic 

character. 

Example: 

When the SKIP statement in the following sequence of control statements is processed 
control skips to ENDIF, LABEL1 , and none of the control statements between these two ' 
statements are processed. 

SKIP (LABEL 1) 

any sequence of 
control statements 

ENDIFUABEL1) 



IFE STATEMENT 

The IFE statement conditionally initiates the skipping of a group of succeeding state- 
ments. The condition is the true or false value of an expression within the IFE state- 
ment. If the expression is true, control passes to the next statement; if the expression 
is false, control skips to a terminating statement with a label string matching the label 
string specified in the IFE statement. The terminating statement must be either an 
ENDIF or an ELSE. If neither an ENDIF nor an ELSE statement with a matching label is 
found, all the remaining statements are skipped. 

The format of the IFE statement is: 
IFE, exp, Is. 

exp A CCL expression. The separator following exp must be a comma. 

Is Label string; 1 to 10 alphanumeric characters beginning with an 

alphabetic character. 
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Example: 

The following control statements initiate the compilation and execution of a FORTRAN pro- 
gram and then test for any errors during execution. If an error was made, the error code 
is displayed. (The DISPLAY statement is explained later in this section. ) 

FTN,I=IFTST. 

SET(EF=0) INITIALIZE ERROR FLAG 

NOEXIT. 

LGO. 

ONEXIT. 

IFE,EF.NE.0,LABL1. 

DISPLAY(EF) 

ENDIF, LABL1. 



If the program executed without error, the error flag (EF) equaLs zero. In this case, 
control passes to the ENDIF, LABL1 statement. If an error occurs, the error flag register 
(EF) does not equal zero, the statement is true, and control passes to the next statement; 
CCL then displays the error code in the error flag register. 

In the following sample dayfile segment resulting from processing of the above statements, 
the FORTRAN program attempted to call a subroutine BETA which did not exist (outside the 
field length of the job). 

16.30.35.FTN,I=IFTST. 

16.30.36. .052 CP SECONDS COMPILATION TIME 

16.30.36.SET(EF=0) INITIALIZE ERROR FLAG 

16. 30. 37. NOEXIT. 

16. 30. 37. LGO. 

16.30.38. NON-FATAL LOADER ERRORS - 

16.30.38. UNSATISFIED EXTERNAL REF -- BETA 

16.30.38. CPU ERROR EXIT 01 AT 404254. 

16. 30. 38. ONEXIT. 

16. 30. 38. IFE,EF.NE.0,LABL1. 

16.30.38.DISPLAY(EF) 

16.30.38. 1 1B 

16.30.38.ENDIF.LABL1. 



ELSE STATEMENT 

The ELSE statement acts the same as a SKIP statement unless it is placed after an IFE state- 
ment. Neither a SKIP nor an ELSE statement terminates skipping initiated by another SKIP 
or ELSE statement. If an ELSE statement follows an IFE statement, four possibilities of 
skipping can occur. These are: 

• The ELSE statement has the same label as the IFE statement, and the expression 
in the IFE statement is true. In this case, all statements following the IFE state- 
ment up to the ELSE statement are processed. The ELSE statement then initiates 
a skip to the ENDIF statement with a matching label. 
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• The ELSE statemeot has the same label as the IFE statement, and the expression 
in the IFE statement is false. In this case, control skips to the ELSE statement 
and then continues processing. The ENDIF statement is ignored. 

• The ELSE statement has a different label from the IFE statement, and the expres- 
sion in the IFE statement is true. In this case, all statements following the IFE 
statement up to the ELSE statement are processed. The ELSE statement then 
initiates a skip to the ENDIF statement with a label matching that of the ELSE 
statement. 

• The ELSE statement has a different label from the IFE statement, and the expres- 
sion in the IFE statement is false. In this case, control skips to the ENDIF state- 
ment that has a label matching that of the IFE statement. 

The format of the ELSE statement is: 

ELSE(ls) 

is Label string; 1 to 10 alphanumeric characters beginning with an alphabetic 

Example: 

The following control statements test a file named TEST1 to determine if it is local to the 
job. (Testing with the FILE function is explained later in this section. ) If the file is local, 
it is copied to the OUTPUT file; if it is not, it is assumed to be an indirect access perma- 
nent file, and a local copy is obtained and copied to OUTPUT. 

If the test shows the file is local, each succeeding statement is processed up to the ELSE 
statement, which initiates a skip to the ENDIF statement. If the test shows the file is not 
local, control skips to the ELSE statement and each succeeding statement after the ELSE 
statement is processed. 

IFE,FILE(TEST1 ,L0) ,LABEL1 . 

C0PYSBF(TEST1 .OUTPUT) 

ELSE(LABELI) 

GET(TESTI) 

C0PYSBF(TEST1 .OUTPUT) 

ENDIF(LABELI) 

The following sample segment of a dayfile results when the above control statements are 
processed and TEST1 is not initially a local file. 

1 1 . 33. 00.IFE, FILE(TEST1 ,L0) .LABEL1 . 

11.33.00.ELSECLAREL1) 

11.33.00.GET(TESn) 

11.33.00.COPYSBF(TEST1 .OUTPUT) 

11.33.01. END OF INFORMATION ENCOUNTERED. 

11.33.01.ENDIF(LABEL1) 

The following sample segment of a dayfile results when the above control statements are 
processed and TEST1 is initially a local file. 

15.40. 19. IFE, FILE (TEST1.L0), LABEL 1. 

15.40. 19. C0PYSBF(TEST1, OUTPUT) 

15.40.21. END OF INFORMATION ENCOUNTERED. 

15.40.21.ELSECLABEL1) 

15.40.21.ENDIFUABEL1) 
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ITERATIVE STATEMENTS (WHILE AND ENDW) 

The CCL iterative statements WHILE and ENDW bracket a group of control statements into 
a loop that can be repeatedly processed. The beginning of the loop is identified by a WHILE 
statement and the end by an ENDW statement. The ENDW statement must have a label 
string that matches the label string specified on the WHILE statement. The loop is repeated 
as long as the expression in the WHILE statement is true. If the expression is never true, 
control immediately skips to the ENDW statement; if no ENDW statement is found, all the 
remaining statements in the control statement record are skipped. 

Label strings of all WHILE statements within the control statement record of a job should 
be unique. Duplication of a label string within a control statement record or within a proce- 
dure can produce unpredictable results. The same label string can be used in a called 
procedure and in the calling control statement record or procedure. 

The formats of the WHILE and ENDW statements are: 

WHILE, exp, Is. 

ENDW. Is. 

exp A CCL expression. The separator following exp must be a comma. 

Is Label string; 1 to 10 alphanumeric characters, beginning with an alphabetic 

character. 

Example: _ 

The following control statements Initiate a loop w.*. "*- repeated five times. 

SCT(R2s5) 

WHILE, R1 .LT. R2,FINISR. 

SEKRURW1 ) 

DISPUY(RI) 

ENDWJFINISH. 



The user can vary the number of repetitions by setting different values in R2 (The 
SET and DISPLAY statements are explained later in this section. ) 
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ADDITIONAL CCL STATEMENTS 



SET STATEMENT 

The SET statement enables the -user to set the value of the following special CCL 
symbolic names. 

Name Description 

Rl Contents of control register Rl. 

R2 Contents of control register R2. 

R3 Contents of control register R3. 

RIG Contents of global control register 1. 

EP Error flag. 

EFG Global error flag. 

DSC Dayfile skipped control statement flag. 

The SET statement format is: 

SET(sym=exp) 

sym One of the symbolic names listed above. 

exp A CCL expression. 

The CCL symbolic names Rl, R2, R3, and RIG reference software registers which are 
initially zero. Only the user can set values in these registers by using an expression 
in the SET statement. The expression is evaluated and stored as an 18-bit, signed 
integer. If the expression is too large, it is truncated (retaining the sign, if signed), 
and no error message is issued. 

The values that the user sets in these registers are available to procedures existing apart 
from the control statement record. (Procedures are described later in this section. ) 

Values set in the Rl, R2, and R3 registers can be used by a called procedure, but when 
control returns to the caller, CCL sets Rl, R2, and R3 to their values before the call. 
For example, PROC1 sets Rl to 1 and then calls PROC2. PROC2 sets Rl to 2 and returns 
to PROC1. Rl returns to its former vaiue of 1. 

A value set in the global control register, RIG, is available not only to the procedure but 
remains in the register when control returns to the caller. 

The error flags, EF and EFG, are 6-bit, unsigned quantities initially set to zero. Either 
the user or CCL can change their values. Usually CCL sets the flags to error codes. It 
sets EF whenever an error is generated during job or procedure processing; it sets EFG 
during procedure exiting if EFG is zero and an error is generated during procedure 
processing. 
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If the user sets values in EF or EFG in the control statement record, these values are 
available to all procedures called. If the user sets values in EF or EFG in a procedure, 
only EFG retains the new value when control reverts from the procedure; EF returns to the 
value it had before the procedure was called. 

If CCL encounters an error in a procedure, it sets the appropriate error code in EF but not 
in EFG. When control reverts, EF returns to its previous value. If EFG was zero when the 
error occurred, it is set to the error code when control reverts; if EFG was nonzero when 
the error was made, it retains its prior value. 

For example, assume that EF and EFG are zero when PROC1 calls PROC2. In PROC2, an 
error occurs and EF is set to the appropriate error code. When control reverts to PROC1, 
EF is set to zero and EFG is set to the error code of the PROC2 error. 

The CCL range of values for EF and EFG are system- defined numerical values for the 
following special symbolic names. 



Description 

Arithmetic error 

CPU abort 

ECS parity error 

File limit error 

Forced error 

Monitor call error 

Mass storage error 
(equivalent to track limit) 

Operator drop 

Operator kill drop 

Override error 

CPU parity error exit 

PPU abort 

Program stop error 

Job rerun 

SRU limit error 

Subsystem abort 

System abort 

Track limit 

Time limit error 



Symbol 


Decimal 
Value 


ARE 


1 


CPE 


4 


ECE 


15 


FLE 


7 


FSE 


10 


MNE 


5 


MSE 


8 


ODE 


11 


OKE 


13 


ORE 


18 


PEE 


16 


PPE 


3 


PSE 


2 


RRE 


12 


SRE 


9 


SSE 


14 


SYE 


17 


TKE 


8 


TLE 


6 
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Examples: 

The following procedure file with three procedures is an indirect access permanent file 
with the name SET FILE. 

.PR0C.P1. 

DISPLAY(RI) 

DISPLAY(RIG) 

SET(R1=9) 

SET(R1G=888) 

end-of-record 

.PR0C.P2. 

GET(ABC) 

DISPLAY(EF) 

DISPLAY(EFG) 

end-of-record 

.PR0C,P3. 

GET(BASICI) 

BASIC . 

DISPLAY (EF) 

DISPLAY(EFG) 

end-of-record 

end-of-file 

The following control statements set and display registers Rl and RIG. A procedure 
is called which displays these registers, resets them, and then reverts to the control 
statement record where they are again displayed. 

SET(R1=1) 

SET(R1G=10) 

DISPLAY (R1) 

DISPLAY (RIG) 

BEGIN,P1,SETFILE. 

DISPLAY(RI) 

DISPLAY(RIG) 



The following is a sample dayfile segment resulting from processing of the above 
control statements. 

16.34.42.SET(R1=1) 
16.34.42.SET(R1G=10) 
16.34.43.DISPLAY(R1) 
16. 34. 43. 1 1B 
16.34.43.DISPLAY(R1G) 

16.34.43. 10 12B 
16.34.43.BEGIN,P1,SETFILE. 
16.34.44.DISPLAY(R1) 

16.34.44. 1 1B 
16.34.44.DISPLAY(R1G) 
16.34.44. 10 12B 
16.34.44.SET(R1=9) 
16.34.44.SET(R1G=888) 
16. 34. 44. REVERT. CCL 
16.34.44.DISPLAY(R1) 

16.34.44. 1 1B 
16.34.45.DISPLAY(R1G) 

16.34.45. 888 1570B 
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The Rl and RIG registers retain their .setting when the procedure is called. However, 
after new values are set in the procedure and control reverts to the control statement 
record, Rl returns to its previous value and RIG retains the value set in the procedure. 

The following control statements set values in the error flags EF and EFG and then call 
a procedure which attempts to access an indirect access permanent file. Control 
reverts to the control statement record where EF and EFG are displayed to see if any 
error code generated is returned via these flags. 

NOEXIT. 
SET(EFrlO) 
SET(EFG=20) 
DISPLAY(EF) 
DISPLAY (EFG) 
BEGIN, P2.SETFILE. 
DISPLAY (EF) 
DISPLAY (EFG) 

The following sample dayfile segment results when the above statements are processed. 

16. 13.35. NOEXIT. 
16.43.35.SET(EF=10) 
16.43. 35. SET(EFG=20) 
16.43- 35. DISPLAY(EF) 
16.43.35. 10 12B 

16. 43. 35. DISPLAY (EFG) 

16.43.35. 20 24B 
16.43. 35. BEGIN, P2,SETFILE. 
16.43.36.GETUBC) 

16.43.36. ABC NOT FOUND, AT 000121. 
16.43. 36. DISPLAY(EF) 

16.43.36. 3 3B 

16.43.36.DISPLAY(EFG) 

16.43.36. 20 24B 
16. 43. 36. REVERT. CCL 
16.43.37.DISPLAY(EF) 

16.43.37. 10 12B 
16.43. 37. DISPLAY(EFG) 
16.43.37. 20 24B 

The procedure attempts to get a permanent file which does not exist. This changes EF 
to the error code 3. It does not affect EFG. Control reverts to the control statement 
record and displays EF and EFG. EF returns to its initial setting; EFG remains 
unchanged throughout. 

To return the error code generated in a procedure to the control statement record, 
EFG must be zero before there is an exit from the procedure. This is demonstrated 
by the following control statements. 

NOEXIT. 
SET(EF=10) 
BEGIN, P3.SETFILE. 
DISPLAY(EF) 
DISPLAY(EFG) 
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A sample dayfile segment resulting from processing of the above statements shows how 
the error code is returned. 

09.42.52.N0EXIT. 
09.42.52.SET(EF=10) 

09.42.52.BEGIN,P3,SETFILE. 

09.12.53.GET(BASIC1) 

09. 42. 55. BASIC . 

09i42! 56! INPUT FILE EMPTY OR MISPOSITIONED 

09.42,56.DISPLAY(EF) 

09.U2.56. 4 4B 

09.42.57.DISPLAY(EFG) 

09.42.57. OB 
09. 42.57. REVERT. CCL 
09.42.58.DISPLAYCEF) 

09.42.58. 10 12B 
09.42. 58. DISPLAY(EFG) 
09.42.58. 4 4B 

The procedure attempts to compile a BASIC program that is not an INPUT record. 
This generates an error code of 4 in EF but does not affect EFG while control is still 
within the procedure. When control reverts to the control statement record, EF 
returns to its original setting, and the error code of 4 is set in EFG. 

The symbolic name DSC (dayfile skipped control statement flag) is initially zero. 
Under this condition, statements that are skipped during processing are not written in 
the dayfile. If the user sets DSC to 1, all skipped statements are written in the 
dayfile with two leading periods added to each statement skipped. The user can 
alternately set DSC to and 1 any number of times. Some CCL error processing 
routines set DSC to 1 and force skipped statements to be written in the dayfile. 

Example : 

The following control statements demonstrate the effect of DSC=0 and DSC=1. 

SET(DSC=0) 

SKIP(LABLI) 

COMMENT. SINCE THE DAYFILE SKIP 

COMMENT. CONTROL IS SET TO ZERO, 

COMMENT. THESE STATEMENTS WILL NOT 

COMMENT. APPEAR IN THE DAYFILE. 

ENDIF(LABLI) 

SET(DSC=1) 

SKIPCLABL2) 

COMMENT. SINCE THE DAYFILE SKIP 

COMMENT. CONTROL IS NOW SET TO ONE, 

COMMENT. THESE STATEMENTS WILL 

COMMENT. APPEAR IN THE DAYFILE AND 

COMMENT. EACH WILL BE FLAGGED 

COMMENT. WITH TWO INITIAL PERIODS. 

ENDIF(LABL2) 
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The following is a sample dayfile segment resulting from processing of the preceding 
control statements. 

16.49.36.SET(DSC=0) 

16.49.36.SKIPCLABL1) 

16.49. 36. ENDIF(LABLI) 

16.49.37.SET(DSC=1) 

16.49.37.SKIPCLABL2) 

16. 49. 37... COMMENT. SINCE THE DAYFILE SKIP 

16. 49. 37... COMMENT. CONTROL IS NOW SET TO ONE, 

16. 49. 37... COMMENT. THESE STATEMENTS WILL 

16. 49. 37... COMMENT. APPEAR IN THE DAYFILE AND 

16. 49. 37... COMMENT. EACH WILL BE FLAGGED 

16. 49. 37... COMMENT. WITH TWO INITIAL PERIODS. 

16.49.37.ENDIFCLABL2) 



DISPLAY STATEMENT 

The DISPLAY statement evaluates an expression and sends the result to the user day- 
file in both decimal and octal integer formats. The largest decimal value which can 
be displayed is 10 digits. If the value is larger than 10 digits, GT followed by 
9999999999 is displayed. If the value is negative and larger than 10 digits, LT 
followed by a minus and 9999999999 is displayed. In octal code, numbers as large as 
20 digits can be displayed. For an expression larger than 2 48 -l, zeros are displayed. 

The format of the DISPLAY statement is: 

DISPLAY(exp) 

exp A CCL expression 
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Example : 

The following sample dayfile shows several display operations. 



15.11.59.DISPLAYCTIME) 

15.14.59. 1514 2752B 

15.15.07.SET(R1=99) 

15.15.21.SET(R2=901) 

15.15.28.DISPLAY(R1) 

15.15.28. 99 143B 

15.15.38.DISPLAY(R1+R2) 

15.15.38. 1000 1750B 

15.15.47.DISPLAY(3/2) 

15.15.47. 1 1B 

15.16.04.DISPLAY(2»*47) 

15.16.04. GT 9999999999 4000000000000000B 

1b.16.15.DISPLAY(-2**47) 

15.16.15. LT -9999999999 -4000000000000000B 

15.16.27.DISPLAY(2»«48) 

15.16.28. OB 

15.16.41.DISPLAY(99999999999) 

15.16.41. CCL156- STRING TOO LONG - 99999999999 



The first DISPLAY statement displays the value of the TIME symbolic name. The 
current time given is in the form hhmm. The next six lines demonstrate the use of the 
Rl and R2 symbolic names. The other DISPLAY statements specify numeric expres- 
sions. The integer constant in the final DISPLAY statement has more than 10 digits 
resulting in an error message. * 

FUNCTIONS 

Functions are available for use as expressions or parts of expressions in CCL state- 
ments. These functions are not statements in themselves but must be part of a CCL 
statement. The CCL functions are FILE, DT, NUM, and SS. 



FILE FUNCTION 

I The FILE function determines the attributes of a file assigned to the job. 
The format of the FILE function is: 
FILE(lfn, exp) 

Ifn Name of the file for which attributes are being determined. 

exp An expression consisting of operators and special FILE symbolic 

names, which is evaluated as TRUE or FALSE for file lfn. 
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The parentheses and comma must be used exactly as shown in the format. The 
expression within a FILE function cannot include the NUM function, the SS function, or 
another FILE function; only the DT function or the following symbolic names can be 
used within the expression. Any other symbolic name within the expression is treated 
either as an implicit DT function (refer to the description of DT following) or as an 
unidentified variable. 



Symbolic Name 
AS 
BOI 

EOF 

EOI 

EQ 

EX 

ID 

IN 

LB 

LI 

LO 

MD 

MS 

OP 

PH 

PM 

PR 

PT 

RA 

RD 

RM 

TP 

TT 

WR 



Description 

File is assigned or attached to the user's control point. 

File is positioned at BOI. This is valid only for a file on mass 
storage. 

The last operation was a forward operation which encountered 
an EOF and is now positioned at that EOF. 

The last operation was a forward operation which encountered 
an EOI and is now positioned at that EOI. 

Equipment number where file exists. 

File is execute only. 

File ID value. 

File is an input file type. 

File is a tape which is labeled. 

File is a library file type. 

File is local file type. 

File has modify permission. 

File is on mass storage. 

File is opened. 

File is a punch file type. 

File is direct access permanent file type. 

File is a print file type. 

File is a primary terminal file type. 

File has read and allow append permission. 

File has read permission. 

File has read and allow modify permission. 

File is on magnetic tape. 

File is assigned to terminal. 

File has write permission. 
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Example: 

The following sample segment from a dayfile shows the FILE function being used inside a 
DISPLAY statement to determine if a specified file is at BOI. 

15. 50. 09. GET (ACCT) 

1 5 . 50 . 09 . DISPLAY(FILE ( ACCT , BOI ) ) 

15.50.09. 1 1B 

15.50.09.COPYBR(ACCT,ITEM) 

15.50.09. COPY COMPLETE. 

15 . 50 . 09 . DISPLA Y(FILE ( ACCT , BOI ) ) 

15.50.09. 0B 



DT FUNCTION 

The DT function determines'the device type on which a file resides. DT can be used only 
within the expression of a FILE function. The value of the DT function is true if the 
2-character mnemonic included in the function is equal to the 2-character device type. The 
operating system defines the mnemonics. 

The format of the DT function as used in the FILE function is: 

FILEflfr. )T(dt)) 

lfn Name of the file for which device residence is being determined. 

dt A 2-character mnemonic identifying the device, which may be any one 

of the following: 

Type Equipment 

CP 415 Card Punch 

CB 405 Card Reader 

DE Extended core storage 

DI 844-21 Disk Storage Subsystem (half track) 

DJ 844-4x Disk Storage Subsystem (half track) 

DK 844-21 Disk Storage Subsystem (full track) 

DL 844-4x Disk Storage Subsystem (full track) 

I DM 885 Disk Storage Subsystem (half track) 

DP Distributive data path to ECS 

| DQ 885 Disk Storage Subsystem (full track) 

LP Any line printer 

LR 580-12 Line Printer 

LS 580-16 Line Printer / 

LT 580-20 Line Printer 

MS Mass storage device 
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Type Equipment 

MT Magnetic tape drive (7-track) 

NE Null equipment 

NT Magnetic tape drive (9-track) 

TT Time- sharing terminal 



NUM FUNCTION 

The NUM function determines if a character string is numeric or not. It evaluates the 
character string as true (1) if it is numeric or false (0) if it is not. NUM must be used as 
an expression or as part of an expression in a CCL statement. 

The format of the NUM function is: 

NUM(c) 

c A character string of 1 to 40 characters. If c is a literal 

($ -delimited), it is always nonnumeric. 



SS FUNCTION 

The SS function determines or sets the current subsystem being ""*— a job. SS. must be 
used as an expression or as part of an expression in a CCL statement. 

The format of the SS function is: 

SS 

or 

SS=name 

name Identifies one of the following subsystems: 

ACCESS BATCH FORTRAN NULL I 

BASIC EXECUTE FTNTS TRANACTT | 

The statement containing the SS function must end with a valid terminator. The SS function | 
cannot be used in the FILE function. If it is, an error message (CCL152) is issued and the 
job step aborts. 

The SS function is intended for use at a time— sharing terminal to determine and set sub- 
systems by means of procedure calls. 



t Not applicable to IAF. 
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PROCEDURES 

A procedure is a group of control statements which exist apart from the control statement 
record of any job. (A procedure may include the time- sharing commands described in 
appendix E. ) The purpose of a procedure is to preserve a sequence of control statements 
for access by a control statement record or another procedure. 

A procedure is stored as a record on a file and is initiated in a job either by a CCL BEGIN 
statement or a call-by-name statement. This is similar to the way a program calls a sub- 
routine. Several procedures can exist on one file and the file may be a local file, an 
indirect access permanent file, or an attached direct access permanent file. A procedure 
file can reside on magnetic tape as well as mass storage. 

1 NOTE | 

A CCL procedure should not include a CLEAR state- 
ment or a NEW or OLD statement without the ND 
parameter. These statements return working files 
required by CCL when it reverts to the previous 
level within the job sequence of control statements. 

STRUCTURE OF A PROCEDURE 

A procedure consists of a procedure header statement and a procedure body. The procedure 
header statement must be the first line in the procedure. It names the procedure and 
identifies any formal keywords that can be used to transmit values to the procedure from the 
call statement. 

The procedure body contains all statements between the header statement and the end-of- 
record or end-of-file. An informative error message is issued if the body does not contain 
at least one control statement. All control statements, including CCL statements, are 
legal within a procedure. The body can also include special procedure commands and data 
(explained later in this section). 

Although a line of a procedure file can contain 150 characters, CCL interprets only the 
first 80 characters; it ignores characters 81 through 150. If there is no end-of-line indica- 
tor in the first 150 characters, CCL assumes that a new line begins at character 151 If the 
new line is not a legal CCL statement or command, it is interpreted as a control statement 
error when executed. 



PROCEDURE HEADER STATEMENT 

A procedure header statement must begin with a period followed by the characters PROC 
The separators between parameters must be commas, and the header statement must be ' 
terminated by a period. Unless the header statement contains an error, it is not printed 
in the dayfile. 

The format of the procedure header statement is: 
. PROC, pname, P r P 2 , . . . , p . 
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pname Name of the procedure; 1 to 7 alphanumeric characters. It can begin 
with a numeric character. 

p. Optional dummy parameters used in the body of the procedure. These 

1 dummy parameters are replaced by parameters on the procedure call 

statement or by default values in the procedure header. The following 
formats are legal. 

fk 

fk= 

fk=defaultl 

fk=defaultl /default2 

fk=/default2 

fk means formal keyword, an identifier that can have meaning by itself 
or in conjunction with other parameters. If the call statement specifies 
for fk, a parameter value identical to fk, then defaultl is overridden and 
default2 is used if specified on the header (refer to Keyword Substitution 
in this section). 

The formal keyword fk can be 1 to 10 alphanumeric characters. Any one of the defaults 
can be 1 to 40 characters, fk and/or the defaults can be $-delimited character strings. If 
a default is a $-delimited character string, it can contain special characters, fk can never 
contain special characters. The maximum number of keyword specifications in a procedure 
header statement is an installation- defined parameter. The default is 50. 

Keywords can designate numeric values, variables, and file names. These appear as 
operands in the body of the procedure. When CCL calls a procedure, it searches the 
procedure body for any formal keywords declared on the header statement. ► "*"" '"on 
occurs when CCL replaces formal keywords in the procedure body with default values from 
the header statement or values from the call statement. The parameters on the call state- 
ment determine which values replace the formal keywords. 

Two special defaults can be used in a procedure header statement to identify a data record or 
a data file to be referenced by the procedure. These defaults are specified with a formal 
keyword as follows: 

fk= sFILE 
fk= =DATA 

The equivalence character (s ) is the pound character (#) in ASCII. Like any other defaults 
in the header statement, these two can be overridden by specifications in a procedure call 
statement. (Use of defaults is explained in Keyword Substitution later in this section. ) 

The default specification fk==FILE in a procedure header statement associates the name 
specified by fk with the record that immediately follows the procedure in the same file. The 
user can place data in this record and reference it in the procedure with statements that 
include the name given to fk. 

An example that illustrates procedure access of a data record is outlined in figure 1-4-1. 
The left side of the figure shows a file PROFIL1 with two procedures. The second procedure 
contains an FTN statement that gets its input from a record on a separate file INFILE. The 
right side of the figure shows the same operation with the FTN input coming from an addition- 
al record on the same file, PROFIL2. This additional record is the default referenced by 
sFILE. (Use of the BEGIN statement and keyword substitution is explained later in this 
section. ) 
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The user can format a data file within the- procedure itself using CCL procedure commands 
(refer to Procedure Commands). When the procedure is called, this formatted data is 
written on a separate file which the procedure can reference. When the user formats this 
data file, he can name it or accept the system default. In the case of the default, the 
procedure references the data file via an fk==DATA keyword specification in the header 
statement and the inclusion of fk in a subsequent statement. 

PROCEDURE EODY 

The procedure body consists of all the statements between the procedure header state- 
ment and the end-of-record. These statements can be control statements, CCL state- 
ments (including calls to other procedures), and CCL procedure commands. The param- 
eters in these statements can be a mixture of values defined in the procedure body and 
keywords defined in the procedure header statement. When the procedure is called, 
substitutions are made for the keywords, and the procedure body becomes the con- I 

trol statement record until a REVERT is encountered (substitution and the REVERT 
statement are explained later in this section). 

& (# in ASCII) can be placed immediately before a keyword in a procedure statement to 
inhibit substitution in that keyword. If two such characters (==) are placed immediately 
before a keyword, substitution takes place and one a is retained. If a single s is used 
with a nonkeyword, it has a null effect since no substitution takes place anyway. If ss 
is used before such a parameter, one = is retained. The s does not affect a separator. 

The right arrow (-*■) is the underline character (_) in ASCII. It can be used in a 
procedure statement to make a preliminary separation of two parameters (keyword or 
nonkeyword). After possible substitutions are made, the two parameters are joined, 
into one. An & before a — retains the -*• and allo\ * ""ttttion. A -» before an s 

does not affect the inhibiting action of the m . 

Representative alterations of parameters in a procedure body by use of an = and a -*• 
are shown in table 1-4-2. 
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TABLE 1-4-2. ALTERATIONS OF PARAMETERS IN A PROCEDURE 
BODY BY USE OF = AND — 



Call statement: BEGIN. APROC, APR OCFL. 


Procedure header: . PROC, APROC. FKl =X, FK2 = Y 


. 


Procedure Parameters 

Before 

Substitution 


Procedure Parameters 

After 

Substitution 


Comment 


sFKl.FKl 
I, J 

FK1=FK2 
IaJ 


FKl.X 

I.J 

XFK2 
IJ 


s inhibits substitution in a keyword 
that immediately follows. 


«FK1,FK1 
2sFKI=j?K2 


sX.X 
si. J 

»A=Y 


= = allow substitution if a keyword 
immediately follows and retains one 


FKls.FKl 


X,X 


s does not affect a separator. 


FKl— FK2 
I— J 
FKl— J 
I— FK2 


XY 
IJ 
XJ 
IY 


The — separates two parameters 
before substitutions are made; after 
all substitutions are made, they 
are joined into one parameter. 


s— FKl, FKl 
=— FK1=FK2 


— X.X 

— X=Y 


An = before a — retains the — and 
allows substitution. 


FKl— sFKl 


XFK1 


A — before an = does not affect the 
inhibiting action of the 2 . 



PROCEDURE COMMANDS 

Procedure commands enable the user to format a data file within a procedure and to insert 
documentary comments within a procedure. The commands are in fixed format with a 
period in column 1 and the command name beginning in column 2. A terminator must not 
be used, and nothing else can appear on the same line except the format specifications. 



.DATA Command 

A . DATA command in a procedure specifies the beginning of a sequence of data statements 
that are written on a separate file when the procedure is called. This data file includes all 
the statements, data, and file marks generated by CCL commands up to one of the following. 

• Another . DATA command. 

• A system end-of-record (not an .EOR command). 

• A system end-of-file (not an .EOF command). 

• A system end-of- information. 
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The data file does not include the . DATA command. Parameter substitution continues 
within the data statements. 

The procedure can reference this separate data file with either a user-given name or the 
default sDATA. The default sDATA refers to a temporary file ZZCCLAx. sDATA is 
equated to a formal keyword in the procedure header. All statements that refer to the data 
file specify the formal keyword. 

The formats of the . DATA command are: 

.DATA 

.DATA, If n 

The first format writes the data statements on the default file. The second writes the data | 
statements on the file Ifn. If lfn already exists, it is returned, and a new file is created. 
Hence, the .DATA command cannot add data to an existing file. After the data file is 
written, it is automatically rewound. 

Example: 

The following procedure file is an indirect access permanent file called DATAFIL. 

. PR OC, ALPHA, P1==DATA,X=FTN0UT. 

FTN(I=P1,L=X) 

LGO. 

REPLACE (X=LISTF ID 

.DATA 

PROGRAM TEST(OUTPUT) 

• 

FORTRAN source 
program 

END 



This procedure file is accessed with the following call statement in a control statement 
record of the job. 

BEGIN , ALPHA , DATAFIL. 

A sample of a resulting dayfile is: 

09 . 29 . 09 . BEGIN , ALPHA , DATAFIL. 

09.29. 10. FTN(I=ZZCCLAA,L=FTNOUT) 

uj.cj! i i. .utf Lr br.^'j«ub wnriLniiun urn, 

09.29. 11. LGO. 

09.29. 1«. STOP 

09.29.14. .038 CP SECONDS EXECUTION TIME 

09.29. 14. REPLACE (FTN0UT=LISTFIL) 

09.29. 14. REVERT. CCL 

All input after the .DATA command (the FORTRAN source program) is written onto the 
default temporary file ZZCCLAA. 
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.EOR Command 

The .EOR command is used to separate records in a data file originating in a procedure. 
Whenever an .EOR is placed, an actual end-of-record is recorded when the data file is 
written on =DATA or lfn. Since the data statements are written on an external file, the 
.EOR command has no effect on the system end-of-record that terminates the procedure. 
The . EOR command is valid only after a . DATA command. 

.EOF Command 

The . EOF command generates an end-of-file on the data file originating in a procedure. 
An actual end-of-file is recorded when the data statements are written on sDATA or 
lfn. This command has no effect on the end-of-record that terminates the procedure. 
If the end of the data file format is also the end of the procedure, no . EOF command 
is needed. In this case, an end-of-record mark is added. If the user wants an end- 
of-file mark^ he must include an . EOF command. The . EOF command is valid only 
after a . jjAiA command. 



.* Command 

The . * command enables the user to document a procedure with internal comments. 
These comments appear when the file is copied to output or displayed at a terminal; 
they do not appear in the dayfile when the procedure is processed. The comment, 
which follows the *, can contain any combination of characters. 

An example of a data file written from a procedure on a named file is shown in 
figure 1-4-2. 



PROCEDURE CALL AND EXIT 

A job can call a procedure with the CCL BEGIN statement. The call inserts the procedure 
in the control statement record of the job following the BEGIN. The end of the procedure 
is signaled by the REVERT statement which CCL or the user supplies. 

1 Figure 1-4-3 outlines the calling of a procedure from a job. Once a procedure has been 

called, it in turn can call a second procedure. The calling of a second procedure by a 
I first procedure is outlined in figure 1-4-4. 

BEGIN Statement 

The formats of the BEGIN statement are: 

BEGIN, pname, pfile, p p p 2> p n> 

BEGIN, , pfile, p 1# p 2 , p n . 

pname, p v p 2 , . . . , p n - 

pname The procedure name as declared on the header statement. This 

is a positional parameter. 
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One 

record 

on PFILE3 



PFILE3 




.PROCA 


.DATA,DFILE 




Data for 
first record 


.EOR 






Data for 
second record 


.EOF 






Data for 
third record 



end-of -record 



Next 

record 

on PFILE3 



.PROC.B. 



end-of -record 




When procedure A is called, | 
the data is written on a local 
file named DFILE 



DFILE 



First data record 



end-of -record 



Second data record 



end-of -record 
end-of-file 



Third data record 



end-of -record 
end-of -information 



Figure 1-4-2. Data File Written from a Procedure on a Named File 
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JOBFILE 



PROCEDURE 



JOBCARD 




7/8/9 



mru i 
FILE 



• PROC 



REVERT 
7/8/9 



Figure 1-4-3. Calling a Procedure from a Job 



FIRST 
PROCEDURE 



SECOND 
PROCEDURE 




REVERT 

7/8/9 



REVERT 

7/8/9- 



Figure 1-4-4. Calling a Procedure from Another Procedure 
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pfile The name of the. file on which pname is located. When the 

BEGIN statement is processed, CCL looks for a local file with 
the name pfile. Failing in this, it looks for an indirect access 
permanent file with that name and gets a local copy. If pfile 
is a direct access permanent file, the user must attach it to the 
job before the BEGIN statement is processed. This is a 
positional parameter. 

p. Parameters that can be any of the following forms. 

fk A formal keyword that is the same as a keyword used 

in the procedure header statement. 

fk= Specifies null substitution for the formal keyword fk 

which appears in the procedure header statement. 

v 1- to 40-character symbol or value that does not 

match any keyword in the procedure header. The 
symbol or value is positionally equated to a keyword 
in the header statement. Nonalphanumeric charac- 
ters (other than /) must be within a literal 
($-delimited). 

fk=v The value v is substituted for the formal keyword, fk, 

which appears in the procedure header statement. 

In all forms, the first separator can be a comma or a left parenthesis; the remaining 
separators must be commas. The terminator can be a period or a right parenthesis. 

The second format uses the default procedure name which is the record at the current 
position of pfile. If this default is used and the file is at end- of- information, CCL 
rewinds pfile and calls the first procedure. An exception is the case where the pro- 
cedure file is the INPUT file. 

The first or second format can use the default for the file name which the installation 
defines (PROCFIL is the default). If pfile is specified, CCL searches for a local file 
with that name. Failing that, it issues a GET request to obtain a local copy of an 
indirect access permanent file with that name. 

The third form is used to call a local file or a procedure in the system library. In 
this case, the procedure name must be the same as the name of the file on which it 
resides. 

In the keyword specification fk=v, the parameter v is a user-supplied name or value 
that is substituted in the procedure wherever the keyword fk occurs. Special versions 
of this specification enable the user to substitute either the current numerical values of 
any of the symbolic names listed in table 1-4-1 or a boolean value. These special 
versions are: 

fk=sym 

fk=sym+ 

fk=sym+D 

fk=sym+B 
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In the first form, sym is itself the numeric value which the user supplies If the user 
selects any of the symbolic names in table 1-4-1 for sym in this first form, the name is 
substituted and not the numerical value associated with that name. For the remaining 
three forms with the plus symbol, any of the symbolic names listed in table 1-4-1 or a 
boolean value can be used. (A user- supplied name with a plus is flagged as an error ) 
These plus forms substitute the current numerical value associated with the symbolic 
name and not the name itself. The +D and +B specify decimal and octal evaluations. 

The following demonstration procedure is accessed by a sequence of calling statements 
in the control statement record of the job. 

.PR0C,TEST1,FK. 
COMMENT. FK 

The resulting dayfile shows each calling statement and the evaluations made The 
relevant segment of the dayfile is as follows: 

1 6. 00. M. BEGIN, TEST) ,FKTEST,FK=20. 

16. 00. 45. COMMENT. 20 

16. 00. 45. REVERT. CCL 

16.00.46.BEGIN,TEST1,FKTEST,FK=PNL. 

16. 00. 47. COMMENT. PNL 

16. 00. 47. REVERT. CCL 

16.00,47.BEGIN,TEST1,FKTEST,FK=PNL+. 

16. 00. 48. COMMENT. 1 

16. 00. 49. REVERT. CCL 

16.00.50.SET(R1=10) 

16.00.50.BEGIN.TEST1 ,FKTEST,FK=R1 . 

16. 00. 51. COMMENT. ' 

16. 00. 52. REVERT. CCL 

16.00.52.BEGIN,TEST1,FKTEST,FK=R1+. 

16. 00. 53. COMMENT. 10 

16. 00. 53. REVERT. CCL 

16.00.53.SET(R2=100) 

16.00.54.BEGIN,TEST1,FKTEST,FK=R2+. 

16. 00. 54. COMMENT. 100 

16. 00. 55. REVERT. CCL 

16.00.55.SET(R3=1000) 

16.00.56.BEGIN,TEST1,FKTEST,FK=R3+D. 
16. 00. 58. COMMENT. 1000 

16. 00. 59. REVERT. CCL 

16.00.59.BEGIN.TEST1 ,FKTEST,FK=R3+B. 
16. 01. 00. COMMENT. 1750 

16. 01. 00. REVERT. CCL 
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REVERT Statement 

The REVERT statement terminates procedure processing. The formats are: 

REVERT, comment 
REVERT, ABORT, comment 

comment Character string appended after the statement terminator. This 

comment is especially useful to the time-sharing user because, when 
the REVERT statement is displayed at the terminal, following pro- 
cedure processing, the comment can inform the user as to how the 
procedure reverted. 

The REVERT statement returns control to the statement following the BEGIN statement 
that called the procedure. The REVERT, ABORT statement sets the error flag EF=CPE 
(CPU abort). Unless a NOEXIT has been processed, control goes to the next EXIT state- 
ment in the control statement record (refer to Exit Processing in section 5). 

CCL always appends the following control statements to a procedure record. 



REVERT. CCL 
EXIT. CCL 
REVERT, ABORT. 



CCL 



These statements terminate CCL processing if no user REVERT statements are processed. 

Example: 

The following procedure (REVTST) is on a file called PROCPL. It reverts to the job 
calling it if the named file has no read permission and gives control to the job EXIT 
statement if the namedfile has no read/modify permission. 

.PROC, REVTST, LFN1.LFN2. 

IFE,FILE(LFN1,RD),LABEL1. 

TDUMP(I=LFN1) 

ELSECLABEL1) 

REVERT. NO READ PERMISSION 

ENDIF.LABEL1. 

IFE,FILE(LFN1,RM),LABEL2. 

C0PY(LFN2,LFN1) 

ELSECLABEL2) 

REVERT, ABORT. NO READ/MODIFY PERMISSION 

ENDIF.LABEL2. 



The following two jobs (REVJOB1 and REVJOB2) call the REVTST procedure, 
attaches an execute-only file; REVJOB2 attaches a read and /or execute file. 



REVJOB1 



REV JOB 1 . 

USER ( USERNUM, PASWD , FAMNAME ) 

CHARGE (CHARGNUM.PROJNUM) 

ATTACH (FILE 1/UN=ALTUSER,PW=PW1,M=E) 

BEGIN, REVTST, PROCFL, FILE1.XFIL. 

COMMENT. RETURNS HERE 

EXIT. 

COMMENT. EXIT ON ERROR 



REV J0B2 

USER ( USERNUM , PASWD , FAMNAME ) 

CHARGE (CHARGNUM.PROJNUM) 

ATTACH (FILE2/UN=ALTUSER,PW=PW2,M=R) 

BEGIN , REVTST , PROCFL , FILE2 , XFIL . 

COMMENT. RETURNS HERE 

EXIT. 

COMMENT. EXIT ON ERROR 
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The following are the dayfiles produced by REVJOB1 and REVJOB2. REVJOB1 
processes the REVERT, statement and terminates normally. REVJOB2 processes 
the REVERT, ABORT, statement and terminates via error processing. 

10.09.51. REVJ0B1. 

10.09. 51. USER (USERNUM.PASWD.FAMNAME) 

10.09. 51. CHARGE (CHARGNUM.PROJNUM) 

10.09.51 .ATTACH (FILE1/UN=ALTUSER,PW=,M=E) 

10.09. 52.BEGIN,REVTST,PROCFL,FILE1,XFIL. 

10. 09.53. IFE,FILE(FILE1,RD),LABEL1. 

10.09.53.ELSE(LABEL1) 

10.09.53.REVERT.NO READ PERMISSION 

10. 09. 53. COMMENT. RETURNS HERE 

10.09. 54. EXIT. 

10. 09.54. UEAD, 0.002KUNS. 

10. 09.54. UEPF, 0.020KUNS. 

10.09.54.UEMS, 0.229KUNS. 

10.09.54.UECP, 0.049SECS. 

10.09. 54.AESR. 2.078UMTS- 

10.21. 58.UaP, 6233, 0.128KLNS. 



10. 10.11. REVJ0B2. 

10. 10. 11. USER (USERNUM.PASWD.FAMNAME) 

10. 10. 1 1 . CHARGE CCHARGNUM.PROJNUM) 

10. 10. 1 1 .ATTACH(FILE2/UN=ALTUSER,PW=,M=R) 

10. 10. 12. BEGIN, REVTST,PRQCFL,FILE2,XFIL. 

10.10.14.IFE,FILE(FILE2,RD),LABEL1. 

10.10.14.TDUMP(I=FILE2) 

10.10.14. TDUMP COMPLETE. 

10.10.14.ELSE(LABEL1) 

10.10.14.ENDIF,LABEL1. 

10. 10. 15.IFE,FILE(FILE2,RM),LABEL2. 

10.10.15.ELSE(LABEL2) 

10.10.16.REVERT,AB0RT. NO READ/MODIFY PERMISSION 

10. 10. 16. EXIT. 

10. 10. 16. COMMENT. EXIT ON ERROR 

10.10.16.UEAD, 0.002KUNS. 

10.10.16.UEPF, 0.020KUNS. 

10.10.16.UEMS, 0.303KUNS. 

10.10.16.UECP, 0.059SECS. 

10.10.16.AESR, 2.103UNTS. 

10.22.03.UaP, 6233, 0.192KLNS. 
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KEYWORD SUBSTITUTION 

Once the user has created a procedure, he specifies which keyword substitutions are 
made in the procedure body each time it is called by the values he includes in the list 
of the calling statement. When a call is made to a procedure, CCL compares the 
formal keywords in the call statement with the formal keywords on the procedure header 
statement. It then makes replacements in the procedure body either with default values 
from the header statement or with values specified in the call statement. The user 
should be aware that after substitutions are made, in the procedure body, it is possible 
that some control statements may be expanded beyond 80 characters. For most control 
statements, this is flagged as an error. Exceptions are the ASSIGN, BLANK, LABEL, 
REQUEST, and VSN statements which allow one continuation line. The parameters on 
the call statement determine the values to be used as substitutions in the procedure 
body. CCL statements can be split between two lines if the split is at a separator. 

The basic options a user has in specifying substitutions in a procedure body are listed 
in table 1-4-3. The user's choice is influenced by the mode in which formal keywords 
in the calling statement list are processed. There are two modes in which CCL pro- 
cesses these keywords, positional and equivalence. In positional mode, there is a 
one-to-one serial matching of call statement keywords with keywords on the procedure 
header statement to determine the substitutions to be made in the procedure body. In 
equivalence mode, each call statement keyword is matched with the identical alpha- 
numeric keyword in the procedure list regardless of its position in either list. 

TABLE 1-4-3. BASIC SUBSTITUTIONS IN A PROCEDURE 



Formal Keyword on 

Procedure Header 

Statement 


Parameter Substitutions in 
Procedure Bodyf 


fk 
fk= 
fk=d 
fk=dl/d2 


Null, v, fk 
Null, v, fk 
Null, v, fk, d 
Null, v, dl, d2 


f Definitions of substitutions available: 

fk A formal keyword. 

d A single default. 

dl The first of two defaults. 

d2 The second of two defaults. 

null The substitution for the keyword skipped. 

v A value other than a keyword on the header statement. 
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Processing of the call statement list always begins in positional mode. The switch 
from positional mode to equivalence mode can occur in two ways. 

• An equivalence of the form fk= or fk=v appears in the call list. This initiates 
equivalence mode for that position and all those following in the list. 

• A double default of the form fk=defaultl/default2 appears in the procedure header 
statement. The corresponding position in the call statement and all positions follow- 
ing are processed in equivalence mode. 

Once the switch has been made from positional to equivalence mode, processing remains in 
that mode to the end of the list; there can be no return to positional mode in that call. 

The permissible call statement parameters in positional mode are: 

■ A keyword identical to a keyword in the procedure header statement. This keyword 
can be $ -delimited. 

• A value that does not match any keyword in the procedure header statement. This 
value can be $-delimited. 

• An omitted entry indicated by double commas or by the call list being shorter than 
the procedure list. 

In the first case, the call statement keyword overrides all procedure defaults except a 
double default. For the double default, the second is used. 

In the second case, the call statement value overrides all procedure defaults except a double 
default. The double default is an error since it initiates equivalence mode in the corre- 
sponding position of the call statement, and in that mode, the call cannot use a value that is 
unidentified in the procedure header statement. 

In the third case, the procedure defaults are used. This includes the first default of a 
double default. 

These substitutions are summarized in table 1-4-4. 

The permissible call statement parameters in equivalence mode are: 

• A keyword identical to a keyword in the procedure header statement. This keyword 
can be $-delimited. 

• A keyword identical to a keyword in the procedure header statement that is 
equivalenced to null. This keyword can be $-delimited. 

• A keyword identical to keyword in the procedure header statement that is 
equivalenced to a value not in the header statement. This keyword can be 
$-delimited. 

• An omitted entry indicated by double commas or by the call list being shorter than 
the procedure header list. 
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TABLE 1-4-4. KEYWORD SUBSTITUTION IN POSITIONAL MODE 



Procedure Header 
Statement 


Keyword on 


the BEGIN Statement 


Omit 


fk 


$fk$ 


V 


$v$ 


. PROC, , fk. 


fk 


fk 


fk 


V 


V 


.PROC, ,fk=. 


Null 


fk 


fk 


V 


V 


. PROC, , fk=d. 


d 


fk 


fk 


V 


V 


.PROC, ,fk=dl/d2. 


dl 


d2 


d2 


Error 


Error 


. PROC, , $fk$. 


$fk$ 


fk 


$fk$ 


V 


$v$ 


. PROC, , $fk$=. 


Null 


fk 


$fk$ 


V 


$v$ 


. PROC, , $fk$=d. 


d 


fk 


$fk$ 


V 


$v$ 


.PROC, ,$fk$=dl/d2. 


dl 


d2 


d2 


Error 


Error 



In the first case, the procedure header defaults are substituted. The second default of 
the double default is used. 

In the second case, the null string is substituted. 

In the third case, the value overrides all defaults in the procedure header statement. 

In the fourth case, the procedure defaults are substituted. The first default of the 
double default is used. 

These substitutions are summarized in table 1-4-5. 
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TABLE 1-4-5. KEYWORD SUBSTITUTION IN EQUIVALENCE MODE 





Keyword on 


the BEGIN Statement 


Procedure Header 
Statement 


v^omit 


fk 
or 

$fk$ 


fk= 
or 

$fk$= 


fk=v 
or 

$fk$=v 




V 

or 
$v$t 


.PROC, ,fk. 


fk 


fk 


Null 


V 


Error 


. PROC, , fk-. 


Null 


Null 


Null 


V 


Error 


. PROC, , fk=d. 


d 


d 


Null 


V 


Error 


.PROC, ,fk=dl/d2. 


dl 


d2 


Null 


V 


Error 


. PROC, , $fk$. 


$fk$ 


$fk$ 


Null 


V 


Error 


. PROC, , $fk$=. 


Null 


Null 


Null 


V 


Error 


. PROC, , $fk$=d. 


d 


d 


Null 


V 


Error 


.PROC, ,$fk$=dl/d2. 


dl 


d2 


Null 


V 


Error 



Examples : 

The following four examples match a calling statement with the header statement of the 
procedure called. The parameters are spaced to illustrate positional correlation. 

I 

positional, equivalence 

BEGIN, AA.PFILE, A, B, C,IZ=D. 
.PROC.AA, W, X, Y.'Z. 

positional] equivalence 
BEGIN, BB.PFILE, A, IX, Y=C, Z=D. 

. PROC, BB, 



BEGIN, CC, PFILE, 
. PROC, CC, 

BEGIN, DD, PFILE, 
. PROC, DD, 



W,'X=A/B, Y, Z . 

equivalence 

W=A, X=B, Y=C, Z=D. 

W. X, Y, Z . 

equivalence 

Z=D, Y=C, X=B, W=A, 

W, X, Y, Z . 



If the following statement were in each of the above procedures, 

COMMENT. W X Y Z 

it would, in all four cases, read as follows after substitution. 

COMMENT. A B C D 



I t Assumes the parameter is entered under equivalence mode. 



1-4-38 



60435400 J 



The following sequence of BEGIN statements is included in the control statement record 
of the job. These reference two files, SUBP and SUBE, that have procedures. 

BEGIN, ,SUBP. 

BEGIN, ,SUBP,P1,P2,P3,P4. 

BEGIN,, SUBP, B1,B2,B3. 

BEGIN, ,SUBP,P1=B1,P2=B2,P3=B3,P4=B4. 

BEGIN, ,SUBE. 

BEGIN,, SUBE, P1,P2,P3,P4. 

BEGIN, ,SUBE,P1=,P2=,P3=,P 1 *=. 

BEGIN, ,SUBE,P1=S1 ,P2=S2 ,P3=S3 ,P4=S4. 



The file SUBP is as follows: 

.PR0C,,P1,P2=,P3=DEF,P4=DEF1/DEF2, 
COMMENT. P1 P2 P3 P4 



The file SUBE is as follows: 

.PROC, ,P4=DEF1/DEF2,P1,P2=,P3=DEF. 
COMMENT. P1 P2 P3 P4 



The following is a segment of the dayfile that results when the BEGIN statements are 
processed. 

12. 58. 01. BEGIN,, SUBP. 

12. 58. 02. COMMENT. P1 DEF DEF1 

12. 58. 02. REVERT. CCL 

12.58.03.BEGIN,,SUBP,P1,P2,P3,P4. 

12. 58. 04. COMMENT. P1 P2 P3 DEF2 

12. 58. OH. REVERT. CCL 

12. 58. 05. BEGIN, ,SUBP,B1 ,B2,B3. 

12. 58. 06. COMMENT. B1 B2 B3 DEF1 

12. 58. 06. REVERT. CCL 

12. 58. 07. BEGIN, ,SUBP, P1=B1 ,P2=B2 ,P3=B3,P4=B4. 

12. 58. 09. COMMENT. B1 B2 B3 B4 

12. 58. 09. REVERT. CCL 

12.58. 10. BEGIN, ,SUBE. 

12.58. 13. COMMENT. P1 DEF DEF1 

12.58. 13- REVERT. CCL 

12.58. 14. BEGIN, ,SUBE ,P1 ,P2,P3,P4. 

12.58. 14. COMMENT. P1 DEF DEF2 

12.58. 14. REVERT. CCL 

12.58. 15. BEGIN, ,SUBE,P1 = ,P2= ,P3=,P4= . 

12.58. 16. COMMENT. 

12.58. 16. REVERT. CCL 

12.5B. T6. BEGIN, ,SUBE,P1=S1 ,P2=S2,P3=S3 ,P4=S4. 

12.58. 17. COMMENT. S1 S2 S3 S4 

12.58. 19. REVERT. CCL 

The substitutions made in a procedure that calls a second procedure is shown in figure 
1-4-6. The resultant dayfile is shown on the right side of the figure. 
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CONTROL STATEMENT PROCESSING 



Jobs entering the system consist of one or more logical records. The first logical record 
contains system directives (control statements) which describe the processing that is to 
occur in the job file (job deck). This section describes control statement processing and 
how the control statements affect other aspects of job processing. 

The operating system recognizes three types of control statements. 



Local File Control Statements 



System Control Statements 



Product Set Control Statements 



These statements call files that are assigned 
to the job control point. LGO is the system 
default local file used for retaining object 
code generated by one of the language proc- 
essors. 

These statements are divided into eight 
categories. 

Job control control statements 

File management control statements 

Permanent file control statements 

Load and dump central memory utility 
control statements 

Tape management control statements 

System utility control statements 

Library utility control statements 

Loader control statements? 

The product set control statements call the 
various products available under NOS. Their 
formats are given in the applicable product 
reference manual and in the Applications 
Programmer's Instant. 



CONTROL STATEMENT FORMAT 

All control statements may consist of one to four fields. The first field is the statement 
label field. If present (the field is optional), it begins with a numeric character and 
terminates with a separator character. The field is used only in conjunction with the system 
control language described in appendix H. 



t Refer to the CDC CYBER Loader Reference Manual. 
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The second field, also optional, is a $ of / prefix character which precedes the program 
name. If a $ is present, it indicates that the specified program to be executed must be 
loaded from the system library, t Therefore, even if a local file of the same name is 
present, the system program, not the local program, is executed. 

I h ! / °P tion ma y be used on l °cal file control statement calls. If a / is present, it indicates 
Srmif Pf. ran ) e . t < f rs following the program name are to be processed in the operating system 
format. If a / is not present, the parameters are processed in product set format. The 
default is product set format because most programs specified in local file calls have been 
generated by one of the product set members. The / option does not apply for control state- 
ment calls to programs residing on the system library. For those types of calls 
parameters are processed in the operating system format unless the SC directive to SYSEDIT 
has been entered Refer to the SYSEDIT control statement in the System Maintenance 
Reference Manual for a description of the SC directive. 

The third field contains the name of the program to be executed. The fourth field (optional) 
contains parameters which further define the operation to be performed. The parameter 

Sf n Ct °/k tT , 0m ^ e t .°f^ fLe i d by a se P arat ° r character. A valid terminator character 
must follow the fourth field (or the third fiplH if nn n*™™*^* ,„<> « 

The system allows continuation lines for ASSIGN, BLANK, LABEL, REQUEST, and VSN 
control statements. (For details, refer to Control Statement Rules in section 10. ) 

The following is a comparison of the operating system and product set formats (refer to 
the Applications Programmer's Instant for control statements using the product set format). 



Operating System Format 
Valid separators are 
+-"/=.( 



Product Set Format 

Same as for the operating system 
format. 



and any other character with a display 
code value greater than 44„ except 
* ) $ . and blank. b 



Valid terminators are 



) 



Same as for the operating system 
format. 



Letters, numbers, and the * are 
the only characters allowed in the 
parameter field. The one 
exception to this rule is the use 
of literals (that is, character 
strings delimited by dollar signs). 
Characters other than letters, 
numbers, and the * can be in- 
cluded in literals. No characters 
within a literal have special 
meanings; the system merely 
checks the syntax of the literal. 
The called program must do its 
own processing of the literal. 

Literals are allowed only on 
equipment/file assignment 
control statements and loader 
control statements. 



Any parameter field that includes 
characters other than letters, 
numbers, and the * must be ex- 
pressed as a Literal. 
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Operating System Format 



Product Set Format 



4. All embedded blanks within a 
control statement except those 
appearing in literals are 
ignored. 

5. Comments may appear on the 
control statement but they must 
follow the terminator. They 
may contain any character. 
Comments are not printed for 
some control statements. 

6. Parameters, separators, 
and terminators are stored 
in the user's field length 
beginning at RA+2. The 
characters , . and ) are stored 
as zero. For all parameters 
and all valid separators except 
the comma, their display code 
equivalent is stored. 



4. All embedded blanks within a control 
statement except those appearing in 
literals or after the program name 
are ignored. 

5. Same as for the operating system 
format. 



Parameters are stored in their display 
code equivalent beginning at RA+2. 
Separators and terminators are stored 
as follows: 



Character 


Code (Octal) 


* 




1 


= 




2 


/ 




3 


( 




4 


+ 




5 


- 




6 


9 




10 


) 


or . 


17 


Other valid 


16 




separators 





7. File names are 1 to 7 alpha- 7. File names are 1 to 7 alphanumeric 
numeric characters. characters. File names beginning 

with a numeric character are illegal. 

8. Not NOS/BE compatible 8. NOS/BE compatible 

In general, no parameter can contain more than 7 characters. If a parameter contains 
more than 7 characters, the entire control statement is issued to the dayfile, followed 
by the message: 

FORMAT ERROR ON CONTROL CARD. 
There are two exceptions to this ruLe. If a statement calls a* program from the system 
library that has an ARG= entry point, parameters in the statement can contain more than 
7 characters. If a parameter contains more than 7 characters, the ARG= entry point is 
not present, and the SDM= entry point is present (refer to appendix F in volume 2), the 
statement name (such as DEFINE) is issued to the dayfile but all parameters are suppressed. 

The parameters can appear in either order- dependent or order- independent format. Order- 
dependent parameters are required when the parameters must be passed in a specific order. 
An example of order-dependent parameters is: 

RESEQ(MYFILE, B, , 20) 



I 
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In this example, the system expects the resequencing increment to be passed as the fourth 
parameter; therefore, a separator must be present for the parameter not specified. 

Order- independent parameters may be passed in any order. This is made possible by the 
use of keywords. Keywords are identifiers which have meaning either by themselves or 
when used in conjunction with other parameters. Usually, keywords are passed with a 
parameter and a separator. The separator must not be a comma. When the list of 
parameters is passed to the called program, all separators except commas are also passed. 

Some programs require specific separators (usually =), and others merely require that a 
separator be present. Examples of keyword notation are: 

1. COBOL(I=SFILE. B=BFILE) 

2. COBOL(B=BFILE,I=SFILE) 

3. COBOL(L=0.A,F) 

4. JOBX.T10.CM45000. 

In examples 1 and 2, both parameters and separators are passed to the COBOL compiler 
Since these parameters are order- independent, both statements produce the same result. 

In example 3, two keywords are passed with no separator character or parameter In 
example 4, the keyword is the first character of the parameter. 

The parameters and an image of the control' statement being processed are written in the 
job communication area. The job communication area is the first 110 o words of the user's 
field length, from RA through RA+107 fi . Appendix E in volume 2 describes the first 100 
words of this area. ° 8 

The following control statements produce the same image in CM. Both statements are 
processed using operating system format. 

123, PERMIT (FILEABC, USERAAA=R. USERBBB=W) 
123. $PERMIT (FILEABC, USERAAA=R, USERBBB=W) 

JOB STATEMENT (JOB CARD) 

The job statement (also known as the job card) names the job and may specify job processing 
parameters. The first statement of a job input file must be a job statement. T 

The user can issue the job statement in order-independent or order-dependent format 
In order- independent format, a separator character does not appear between the keyword 
and its value. If the order- dependent format is used and parameter values are omitted 
between separators, the parameter values are interpreted as zeros. A parameter value 
containing an 8 or 9 must not have a B suffix. If there is a syntax error in the job state- 
ment, the system issues an error message and terminates the job. 

The job statement format is: 

. , 79 80 

/jobname(Pp, Tt, CMfl, ECfe) f f~7~m~ 



or 

79 80 



[ / jobname(p, t, fl, fe) > f 



c m 
T Not applicable to time-sharing jobs. 
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jobname 



Alphanumeric job name (1 to 7 characters) which must begin 
with a letter. This name identifies the individual jobs being 
run under the same user number. 



Pp 
or 

P 

Tt 
or 



CMfl 
or 

fl 



Priority level (octal) at which the job enters the system, 
ranging from 1 to 17g. A value containing an 8 or 9 or the 
suffix D is interpreted as decimal. This parameter is not 
used by NOS (refer to Job Scheduling in section 3). 

Central processor job step time limit in seconds. Values 
can range from 1 to 77777. Decimal is the default base. 
Octal values from 1 to 77777 g (1 to 32767) can be entered 
if followed by a B suffix. The default limit is 64 (lOOo). 
Decimal values from 32767 to 77777 set the time limit at its 
maximum. The time limit set by this parameter must be 
sufficient for completion of each of the steps in the job 
(refer to Time Limit Control in section 3). 

Maximum octal field length for the job (refer to Field Length 
Control in section 3). The system rounds the value to the 
next highest multiple of IOO3. ^he ^ ie ^ length cannot exceed: 

377700 g on a 198K or a 262K machine 
360000g on a 13 IK machine 
163000g on a 65K machine 

A value containing an 8 or 9 or the suffix D is interpreted as 
decimal. 



ECfe 

or 

fe 



cm 



Maximum octal number of lOOOg word ECS blocks required 
by the job. This ECS field length cannot exceed 3777 blocks 
or the amount of user ECS allowed by the installation. The 
user job must request the ECS (refer to the RFL control 
statement in section 6) before it can be used. A value 
containing an 8 or 9 or the suffix D is interpreted as decimal. 

Conversion mode entered in columns 79 and 80. f A 26 
indicates that coded cards are to be converted in 026 mode; 
29 indicates cards are converted in 029 mode. This initial 
keypunch mode can be changed within the job by a conversion 
change card (refer to Coded Cards in appendix F) when 
reading cards or a ROUTE statement when punching cards. 
If this parameter is omitted, the installation default keypunch 
mode is used. 



The system issues error messages when parameter specifications exceed validation limits. 
It also issues an error message if an ECS field length is specified when the user's CM 
validation limit is less than lOOQOg words. The user should consult installation personnel 
for further installation restrictions based on the machine configuration and subsystems used. 



t This conversion mode indicator is ineffective for remote batch jobs entered under 
Export/Import or mode 4 RBF; it is effective for remote batch jobs entered under HASP 
RBF. 
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Example: 

JOBAAA, , , 50000, 20. 

has the same effect as: 

JOBAAA, 0, 0, 50000, 20. 

or 
JOBAAA, P0, TO, CM50000, EC20. 

CONTROL STATEMENT PROCESSING FLOW 

The system translates a control statement by: 

1 . Reading the statement from the control point control statement buffer. If necessary, 
the system reads control statements from the job input file. 

2. Deleting all spaces between the beginning of the statement and the terminator 
character (a period or a right parenthesis). In general, the system allows only 
standard FORTRAN characters to appear before the terminator character, although 
other characters can appear within a literal or in the comment field. 

3. Comparing special control statement names with the name of the control statement 
being processed. If the statement name is CTIME, HTIME, RTIME, or STIME, the 
system processes the control statement. 

4. Searching the file name table for a file assigned to the job with a name identical to 
the name of the control statement. However, if a $ precedes the program name, 
this step is skipped. If an identical name is found, the program is loaded into 
memory. The arguments are extracted from the control statement and stored in 
RA+2 through RA+n+1 (n is the number of parameters). The CPU is requested to 
begin execution unless special loader control statements follow. 

5. Searching the central library directory for a program name that matches the control 
statement name. If the name is found, the system proceeds as in step 4; otherwise, 
the system searches further. 

6. Searching the peripheral processor library directory for a program name that 
matches the control statement name. If found, the name is placed, with a maximum 
of two arguments, as a peripheral processor request, and the system exits to the 
program. 

7. If the control statement name is not found during any of the above searches, the 
control statement is declared illegal and the job is aborted. 
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Figure 1-5-1 illustrates the flow of control statement processing. 
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Figure 1-5-1. Control Statement Processing Flow 
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EXIT PROCESSING 

When an error condition occurs during job processing, the system searches the control 
statement record for an EXIT statement. If the record does not contain an EXIT state- 
ment, the system terminates the job. If the system finds an EXIT statement, it clears 
the error condition and processes the control statements that follow the EXIT statement. 
If the error was a time limit error, the limit is reset to the time used plus 10 8 sec- 
onds. This gives the user time for post -error cleanup operations. If the error was an 
SRU limit error, the limit is reset to the SRUs used plus 10 8 SRUs. 

If a NOEXIT statement is encountered, normal error processing is not performed. 
That is, if the no exit flag has been set (by the NOEXIT statement) prior to the error, 
the error flag is cleared, no search is made for an EXIT statement, and processing 
continues with the next control statement. An ONEXIT statement can be used to return 
to error processing mode; it clears the no exit flag. 

The following sequence of control statements illustrates this exit processing. 

JOBCCC. 

USER(SMITH22,SM) 

CHARGE(55A19, 69P5) 

NOEXIT. 

GET(A.B) 

ONEXIT. 

ATTACH(MASTER/M=W) 

SK3PEKMASTER) . 

COPYBF(A. MASTER) 

COPYBF(B, MASTER) 

PACK(MASTER) 

COPYSBF{MASTER, ) 

EXIT 

ENQUIRE(F) 

-EOR- 

-EOI- 

This job gets local copies of two indirect access permanent files and adds them to a direct 
access file. The NOEXIT suspends error processing, and the job continues even if file 
A and/or B is not found. The ONEXIT turns error processing back on. If any error occurs 
thereafter, processing skips to the EXIT statement and continues with the ENQUIRE. If no 
error occurs after the NOEXIT, processing continues until the EXIT statement and 
terminates (ENQUIRE is not processed). 
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JOB CONTROL CONTROL STATEMENTS 



The job control control statements enable the user to alter information that controls his 
job while in the system and to retrieve information concerning the status of his job. 
The control statements included in this category are: 

ACCOUNT MODE ROLLOUT 

CHARGE NOEXIT RTIME 

COMMENT NORERUN SETASL 

CTIME NOTE SETJSL 

DAYFILE OFFSW SETPR 

ENQUIRE ONEXIT SETTL 

ENTER ONSW STIME 

EXIT PASSWOR SUBMIT 

HTIME PROTECT SUI j 

LDI RERUN SUMMARY 

LENGTH RESOURC SWITCH 

LIMITS RFL USECPU 

MFL USER 

The user must have specific validation parameters set to use LDI, PASSWOR, PROTECT, 
SUBMIT, or SUI. He can use the remaining statements regardless of his validation. 
A listing of validation information can be obtained using the LIMITS statement. Although 
the user is allowed to change several control values for his job (such as RFL, SETPR, 
and SETTL), he can never specify more than that for which he is validated. 

The system uses the USER statement and CHARGE statement for checking user valida- 
tion and system accounting information. The RESOURC statement is used by the 
system to prevent deadlocks from occurring when several tapes or packs are used 
concurrently. 

The user can submit files as batch origin type jobs through the LDI and SUBMIT con- 
trol statements. He can specify the mode of error exit processing desired through use 
of the EXIT, ONEXIT, NOEXIT, and MODE statements. He can also set conditions for 
his program with sense switches (such as ONSW, OFFSW, and SWITCH). In the event 
of a system malfunction causing jobs to be recovered, he may either allow his job to be 
run again with the RERUN statement or prevent it from being rerun with the NORERUN 
statement. Additional information is returned to the user by the CTIME, RTIME, STIME. 
HTIME, and DAYFILE statements. The COMMENT statement allows the user to provide 
his own dayfile documentation. 
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ACCOUNT STATEMENT 

The ACCOUNT control statement is included for compatibility with previous systems. 
The USER control statement should be used with the present system. 



CHARGE STATEMENT 

The CHARGE statement causes the system to record on the account dayfile all informa- 
tion regarding resources used under a specified charge number/ project number combina- 
tion. Its purpose is to control the accounting activity of the system for a customer 
or the installation. 

The control statement format is: 

CHARGE(chargenum, projectnum) 

chargenum A 1- to 10-aiphanurnerie character charge number assigned 

to the user. 

projectnum A 1- to 20- alphanumeric character project number assigned 

to the user. 

For added security, the user may issue the CHARGE statement without parameters. 
In this case, the system reads the parameters from a record in the INPUT file. This 
record must be a single line with the format: 

chargenum, projectnum 

The CHARGE statement is used in conjunction with user accounting control. An instal- 
lation which implements this feature can impose limits on the SRUs a user may accumu- 
late or restrict his access to the system to a certain time-of-day interval. 

If access option 8 is not set (refer to LIMITS control statement in this section), the 
user must include a CHARGE statement immediately following every USER statement 
in his job. If option 8 is set, the user may but is not required to include a CHARGE 
statement. A user assigned more than one charge and/or project number may include 
additional CHARGE statements in his job to record resources used under each charge 
number/project number combination. Whenever a new CHARGE statement is issued, 
the SRU information for the previous charge number/project number is written to the 
account dayfile and then cleared. However, the other accumulators (central processor 
time, mass storage activity, and so on) are not cleared but continue to increment. 
The following message is also issued when a new CHARGE statement is entered. 

yy. mm. dd. hh. mm. ss. jobname. ACCN, chargenum, projectnum. 

For a complete list of accounting messages issued to the user's dayfile, refer to Job 
Completion in section 3. 
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COMMENT STATEMENT 

The COMMENT statement enters the specified comment in the system and user's dayfile. 
The control statement format is: 
COMMENT, comments 

or 
*comments 

comments Any combination of characters the user wishes to display 

If the 

*comments I 

format is used, the * must be the first nonblank character. 

CTIME STATEMENT 

The CTIME control statement requests that the accumulated CPU time for the job be issued 
to the user's dayfile (in seconds). 

The control statement format is: 
CTIME. 

DAYFILE STATEMENT 

The DAYFILE control statement causes the system to write the user's control point 
dayfile to the file specified. 

The control statement format is: 

DAYFILE(lfn, strng, op, pd, pi) 

or 
DAYFILE(L=lfn, FR=strng,OP=op, PD=pd, PL=pl) 

L=lfn File on which the dayfile is to be written. If omitted, OUTPUT 

is assumed. Pagination will occur if listing file name is OUT- 
PUT or if PD or PL is specified. 

FR=strng This parameter specifies the literal string for which a search 

is to be made in the dayfile. Unless the literal string is a 
valid command or control statement (7 characters or less), 
it must be enclosed by $ delimiters. The first character of the 
literal string requested must always be the starting position of 
the field (for example, the first character of the time field is a 
space). The field to be searched is specified by the op param- 
eter. The portion of the dayfile from the last occurrence of 
the requested literal string to the end of the dayfile is returned 
to the user. 
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OP-op Selects search option (single character): 

op 

T Search time field for matching string. 

M Search message field for matching string. 

I Incremental dump (from point of last dump). 

F Full dump. 

If a literal string (strng) is specified and op is omitted, OP=M" 
is assumed; if both strng and op are omitted, OP=F is assumed. 

PD=pd Print density (3, 4, 6, or 8 lines per inch); if omitted, PD=6 

is assumed. 

PL = pl Selects page size; if omitted, page size is determined from 

print density. Page size does not include title lines. 







3 


30 


4 


40 


6 


60 


8 


80 



Examples: 

DAYFILE(TEMP,$ABCDEFG$) 

DAY FILE (L=TEMP, FR=$ABCDEFG$, OP=M) 

DA YFILE (FR = COMPA SS) 

ENQUIRE STATEMENT 

The ENQUIRE control statement gives information about the system to the user. Three 
forms of the command are allowed. 

The control statement formats are: 

ENQUIRE(OP=p 1 p 2 . . . Pn, JN=jobname, FN=lfn lf 0=lfn 2 ) 

or 
ENQUIRE(p 1 p 2 ...p n ) 

or 
ENQUIRE. 

p- Any of the following options. 

Option Description 

A Gives listings of the B, D, R, U, J, L, and F 

options, respectively. 
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Option 


Desc 


ription 


B 


Returns identification and 
user. 

Example: 


priority inform 




USER NUMBER 


DLH2500 




USER INDEX HASH 


AKWA 




JOB NAME 


AKQAAEF 




JOB SEQ. NO. 


AAEF 




FAMILY 


CLS127 




PACKNAME 


*NONE*. 




PRIMARY FILE 


*NONE*. 




SUB SYSTEM 


NULL. 




QUEUE PRIORITY 


4010 




CPU PRIORITY 


30 




MAX FL (CM) 


203700 




MAX FL (EC) 







LAST FL (CM) 







LAST FL (EC) 






Returns a listing of the resources the user has de- 
manded and those which have been assigned. 

Example: 

RESOURCE DEMAND INFORMATION. 

RESOURCE DEMAND ASSIGNED 

MT 2 2 

Gives the status of files at the user's control point. An 
asterisk (*) after the file type indicates that the file is 
locked. (The user cannot write on a locked file. ) Refer 
to the FILE function in section 4 for the meaning of the 
file type mnemonics. The STATUS column lists the 
last operation performed on the file. (I/C means 
incomplete. ) 

Example: 

FILENAME LENGTH/PRUS TYPE STATUS 



EXAMP 


2 


LO. 


EOR READ 


INPUT 


3 


IN.* 


EOR READ 


BFILE3 


21 


LO. 


EOR READ 


OUTPUT 


3 


PR. 


I/C WRITE 


TOTAL = 4 









Returns the contents of the user's control registers, 
error flag field, and succeeding control statements. 

Example: 

JOB CONTROL REGISTERS. 

Rl = 32 

R2 = 98 

R3 = 

EF = 
EFG = 
RIG = 



60435400 J 



1-6-5 



Option Description 

CONTROL STATEMENT(S). 

GET (ALPHA) 
COPYSBF(ALPHA, ) 
*EOR* 

If the J option is used within a CCL procedure, only the 
remaining control statements in the procedure are 
listed. 

L Returns user's loader information. 

Example: 

LOADER INFORMATION. 

MAP OPTIONS = SBX 

GLOBAL LIBRARY SET IS - 
EMPTY. 

R Returns to the user the amount of resources used. The 

resources listed include CPU time, mass storage acti- 
vity, magnetic tape activity, and permanent file activity. 
These statistics are factors used in calculating SRUs 
used. 

Example: 

RESOURCES USED. 

CPU TIME 0.025 SECS. 

MS ACTIVITY 0.117 KUNS. 

MT ACTIVITY 0. 000 KUNS. 

PF ACTIVITY 0. 010 KUNS. 

ADDER 0.002 KUNS. 

SRU 2.025 UNTS. 

S Returns the user's accumulated SRUs. The SRU 

represents the total usage of the system by the user. 
This unit is derived from central processor time, I/O 
activity, and memory usage. 

Example: 

SRU ACCUMULATOR. 

SRU 2.030 UNTS. 

T . Returns accumulated CPU time. 

Example: 

CPU ACCUMULATOR. 

CPU TIME 0.017 SECS. 



U 



Returns the initial amount of resources available to the 
user in seconds, job step SRU, account block SRU, and 
the remaining resources available for dayfile messages, 
control statements, dispose files, and mass storage. 
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Option Description 

Example: 

RESOURCE USAGE ALLOWED. 

SECONDS 64 

JOB STEP SRU 128 

ACCOUNT BLK SRU 640 

DAYFILE MESSAGES 462 

CONTROL STATMTS 458 

DISPOSE PILES 4 

MASS STORAGE 12586 

jobname Last 3 characters of the name assigned by the system to 

a job initiated by the SUBMIT, ROUTE, or LDI state- I 

ment. When this parameter is specified, the status of J 

the job is returned. If JN {without =jobriame) is J 

specified, the status of all jobs associated with the 
current user number that are active in the system is 
returned. The user can obtain only the status of jobs 
submitted under the current user number. 

Un^ Local file name. When this parameter is specified, the 

status of the particular file is returned in the same 
manner as when the F option is specified. 

lfn„ Name of alternate file to receive output. If omitted, the 

* system assumes OUTPUT. 

The third form of the statement (ENQUIRE. ) defaults to the OP=A option. All OP= options 
(except S and T) are executed, and the information is printed on the OUTPUT file. 

If the JN=option or FN=option is executed, the information is printed on the OUTPUT file 
only if it is the OUTPUT file for an interactive terminal. Otherwise, this information is 
written in the user's dayfile. 

ENTER STATEMENT 

The ENTER control statement enables the user to enter a series of control statements 
on one line. This is especially useful for time-sharing users operating in the batch 
subsystem. 

The control statement format is: 

ENTER, /statement, /statement,,/. . . /statement 
i & n 

/ Delimiting character used to separate the individual control state- 

ments on one line. It can be any character not used within the control 
statements. It must immediately follow a period or right parenthesis. 

statement. Any NOS control statement for which the user is validated. Time- 
sharing commands for which there are no batch counterparts are 
not acceptable. 
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The system supplies a terminator (period or right parenthesis) if it is missing from any 
statement. 

Example : 

From a terminal, a user enters the batch subsystem and types in an ENTER statement 
on one line as follows: 

BATCH 
$RFL,0. 

/ENTER. #SETCORE(0)#MAP(ON)#FTN(EL=F, I=ENTRFIL#LGO. #OVL. #DMP. #DMP 
(1000) 

This is essentially the sequence of control statements in the job in section 12 used to 
illustrate the reading of CM dumps. However, instead of the FORTRAN program being 
in the INPUT file, it is on a permanent file called ENTRFIL. The printouts shown in 
the figures in section 12 are automatically listed at the terminal after the user presses 
carriage return at the end of the ENTER statement. 

EXIT STATEMENT 

The EXIT control statement indicates the position in the control statement record where 
processing will resume if an error is encountered or where to terminate normal con- 
trol statement processing if an error is not encountered. For additional information 
refer to the description of the NOEXIT and ONEXIT control statements later in this 
section and to the description of exit processing in section 5. 

The control statement format is: 

EXIT. 

HTIME STATEMENT 

The HTIME control statement issues a dayfile message giving the CYBER 170 model 176 
accumulated clock cycle count for the job. A clock cycle on the model 176 is 27. 5 nano- 
seconds. COMPASS instructions require a certain number of clock cycles to execute as 
described in the COMPASS reference manual. This control statement can be used for 
performance comparisons. 

The control statement format is: 

HTIME. 
The resulting dayfile message has the following format. The cycle count is in kilocycle units. 

HTIME nnnnnnnnnnnn. nnn KCYCLES. 

An HTIME statement processed on a machine other than the model 176 produces the 
following dayfile message. 

HTIME NOT AVAILABLE. 
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LDI STATEMENT 

The LDI routine copies lfn to mass storage and submits the job(s) to the input queue 
with IDs to identify each job. The copy begins at the current position of the file pointer 
and continues until an EOI or double EOF is encountered. The jobs submitted are batch 
origin type jobs. LDI does no reformatting of the job file and therefore submit direc- 
tives (/job, /NOSEQ, and so forth) are not allowed. 

The control statement format is: 

LDI (lfn, id, m) 

lin Name of file containing the job(s) to be submitted; if 
lfn is omitted, LOAD is assumed. 

id Identification code (0 through 67 g and 77g); if omitted, 

is assumed. If an id of 77 g is assigned, the 
OUTPUT file is released at job completion. 

m Job names of jobs loaded are listed in the dayfile for 

the control point; if omitted, the list is suppressed. 

The user can submit only the number of jobs for which he is validated (refer to the 
DB field description for the LIMITS control statement in this section). If this limit is 
exceeded, no further jobs are loaded, and the following message is issued to the dayfile. 

TOO MANY DEFERRED BATCH JOBS. 

If the submitted job contains an illegal USER statement, the job entering the LDI state- 
ment is aborted (no exit processing), and the following messages are issued to the 
dayfile. 

ILLEGAL USER CARD. 
SYSTEM ABORT. 

In addition, the following message is issued to the account dayfile. 

SIUN, usernum. 

Terminal users are immediately logged off with no dayfile message. The security count for 
the user number that entered the LDI statement is decremented accordingly. 

LENGTH STATEMENT 

The LENGTH control statement gives the user the current status of one of his local files. 

LENGTH(lfn) 

lfn Name of local file. 

The information given for the local file includes its length in PRUs, type, and current status. 
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LIMITS STATEMENT 

The LIMITS control statement directs the system to List validation information on file 
OUTPUT for the user named on the latest USER statement. 

The control statement format is: 
LIMITS. 

Generally, validation limits are the internal system controls associated with each user 
number which govern his use of certain system resources. The listing provided describes 
both the resources available to the user and the extent to which they may be used. All 
numeric values listed are decimal unless the postradix B appears, signifying an octal value. 
The following information is Listed. 

Field Description 

ABt,tt Answerback identifier (1 to 10 alphanumeric characters) used for ter- 

tv* inn] i«A«fri Ft r% »-v 4> it *"* w* 
1.4.X J. IIGLX lUCULiXl.V.OI'^JLl* 

MT Maximum number of magnetic tape units the user is allowed to have 

assigned to his job concurrently. 

RP Maximum number of removable auxiliary devices the user is allowed 

to have assigned to his job concurrently. 

TL Maximum amount of central processor time (cumulative CPU time 

slices) in seconds allowed for each job step of the user's job. TL 
represents the actual time limit divided by 10g. 

CM Maximum number of central memory words that the user is allowed 

to request. The value stored for CM represents the actual word limit 
divided by 100 g . 

IMF Maximum number of files that the user is allowed to have assigned to 

a job concurrently. 

DB Maximum number of deferred batch jobs that the user can have in the 

system concurrently. 

If the user is validated for system privileges and DEBUG mode is set 
on the system display console or if the user is submitting jobs from 
system origin, this parameter is ignored. The user is allowed to 
submit as many jobs as desired. 

FC Maximum number of permanent files the user can have in the catalog. 

CS Maximum number of PRUs available to the user for indirect access 

files. 

FS Maximum number of PRUs available to the user for any one indirect 

access file. 

PAt,tt Terminal parity (EVEN or ODD). 

ROt,tt Number of rubout characters required for carriage return 

delay. 

PXt,tt FULL or HALF duplex transmission mode. 

TTt.tt Terminal type. 

TCt Character set to be used by time-sharing terminal. 

ISt Initial subsystem for time-sharing terminal. 



t For further information about this field, refer to the IAF Reference Manual or Time- 
Sharing User's Reference Manual, 
tt These fields are not used with network terminals. 
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Field . Description 



MS Maximum number of mass storage PRUs the user is allowed to addition- 

ally allocate via his job. 

DF Maximum number of CPU program messages that the user's job can 

issue to the system and /or job dayfiles. 

CC Maximum number of batch control statements processed for a user. 

(Time-sharing processed control statements are excluded.) 

OF Maximum number of print and punch files the user can dispose to output 

queues . 

CP Maximum number of cards that can be punched from a user's punch file. 

LP Maximum number of lines that can be printed from a user's print file. 

EC Maximum number of ECS memory words that the user is allowed to 

request. 

SL Maximum number of SRUs the user is allowed for a job. 

CN Charge number to which the user is assigned. 

PN Project number to which the user is assigned. 

DS Maximum number of PRDs available to the user for any one direct access 

permanent file. 

AW Access word; controls the user's access within the system according to 

the following options (assumed values are options 0, 2, and 3). 

Option Specifies 

User can change his password. 

1 User can use the privileged time-sharing commands.? 

2 User is allowed to create direct access files. 

3 User is allowed to create indirect access files. 

4 User can have system origin (SYOT) capability for any job 
origin if the system console is in DEBUG mode. 

The user is allowed to assign a device by its EST ordinal 
although the system need not be in DEBUG mode to do so. 

The user is allowed to call the customer engineering PPU- 
based diagnostics if ENGINEERING mode (ENGR) is set at 
the system console. 

5 User can access /create library files. 

6 User can assign nonallocatable devices. A nonallocatable 
device is a magnetic tape unit, card reader, card punch, 
or line printer. Refer to the REQUEST statement in 
section 7 for further information. 

7 User is allowed to access the system without supplying his 
assigned charge and project numbers. 

8 User can define, save, and replace files on auxiliary devices. 

9 User can access special transaction functions for library 
updates and batch transaction processing. 



T For further information about privileged time- sharing commands, refer to the NOS 
Operator's Guide. 
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10 


11 


12 


13 


14 


15-23 


24-35 


36-47 


48-59 



Option "Specifies 

Allows no terminal timeout. 

Allows use of the system control point (SCP) facility. 

User has special accounting privileges, t 

Allows BATCHIO subsystem privileges, tt 

Allows use of the PROTECT statement. 

Reserved. 

Used by Control Data for application validation, f f T 

Available for user application validation. 

Reserved. 

The numerical value listed for AW is an octal representation of the bit settings for the above 
options. Thus bit is option 0, bit 1 is option 1, and so forth. The rightmost octal number 
can designate any combination of options 0. 1, and 2; the next octal number to the left can 
designate any combination of options 3. 4, and 5; and so on. For example, if the access 
word were: 

AW=00000000000 1000002 1 5 

the user would be validated for options 0, 2, 3, 7, and 24. 

If any parameters are included on the LIMITS statement, the system issues the following 
message to the user's dayfile. 

ERROR IN LIMITS ARGUMENTS. 



MFL STATEMENT 

The MFL control statement resets the maximum field length for each subsequent job step. 
The control statement format is: 

MFL(nnnnnn, mmmm) 

or 

MFL(CM=nnnnnn, EC=mmmm) 

nnnnnn Maximum central memory field length (octal is assumed unless deci- 

mal is specified by a D suffix or use of the digits 8 or 9). 

mmmm Maximum extended core storage (ECS) field length. The value of 

mmmm is the actual extended core field length divided by 1000„. 

The parameters may be specified positionally, by keyword, or intermixed positionaily and 
by keyword. If intermixed, the positional parameters are evaluated according to their 
position among all the parameters. 

t Refer to the System Maintenance Reference Manual for a description of special user's 
accounting privileges, 
tt Currently this bit allows the user to use the V carriage control character (refer to 
appendix I), 
ttt These options are described in the System Maintenance Reference Manual. 
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The parameter nnnnnn sets an upper boundary for the field length of subsequent job 
steps. The value cannot exceed the maximum field length for the job nor can it be 
less than 1500, the field length required for the utility (CONTROL) that processes MFL. | 

Likewise, the parameter mmmm sets an upper boundary for the ECS field length of 
subsequent job steps and cannot exceed the maximum field length for the job. If the 
value (zero) is entered for CM or ECS field length, the MFL is set to the maximum 
field length for the entire job. 

The MFL control statement clears any initial running field length previously established 
with the RFL control statement or the SETRFL macro and allows the system to deter- 
mine the field length for each succeeding job step. The system continues to deter- 
mine field lengths until another RFL control statement or SETRFL macro is encountered. 

If the field length requested is greater than 377777 g for CM, or 7777 g for EC, the 
following error message is issued. 

CM OR EC REQUEST EXCEEDS MAXIMUM. 



MODE STATEMENT 

The MODE statement defines the error conditions that cause the system to exit from normal 
processing. When the specified error occurs, the system sets the appropriate error flag 
and exits from normal processing to perform any error processing required. If an error 
occurs for which the exit mode is not selected, the system notes the error, skips the opera- 
tion that is causing the error, and continues normal processing. 

The control statement format is: 

MODE(m, n) 

m CPU program error exit mode (05 m£ 7) 

n CPU hardware error exit mode (0<n£ 7). Included for compatibility 

with earlier versions of NOS. The system now forces n=7 regardless 
of the value specified on the control statement. 

The following values can be supplied for m. 

m CPU Program Error Exit Mode 

Disable program exit mode; no selection made. 

1 Address out of range because: 

• Attempt was made to reference CM or ECS outside 
established limits, or 

• Attempt was made to reference last 60-bit word 
(word 7) in relative address FL of ECS. 

WpCl GIL1U UUt. U-L i. O-ULgO, JLl.UCIbi.LlgpUl.LiL CLX 1 1.11111*2 LIS. Ullll. ICbClfCU 

an infinite operand. 

3 Address or operand out of range. 

4 Indefinite operand; floating-point arithmetic unit received an 
indefinite operand. 

5 Indefinite operand or address out of range. 

6 Indefinite operand or operand out of range. 

7 Indefinite operand, operand out of range, or address out of 
range. If no mode is selected, the system assumes m=7. 
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If exit mode 3, 5, 6, or 7 is specified, a combination of exit modes 1, 2, and 4 
is actually selected. For example, if' exit mode 5 is specified, an error exit occurs 
for either a mode 1 or mode 4 error condition. Refer to Error Control in section 3 
and to the CYBER 170, CYBER 70, and 6000 Series Computer Systems Reference 
Manuals for further information about the processing of mode errors. 



NOEXIT STATEMENT 

The NOEXIT control statement suppresses the transfer of control to the statement 
following the next EXIT statement Lf an error occurs. 

The control statement format is: 

NOEXIT. 

If a NOEXIT statement has appeared in the control statement record and an error 

I occurs, processing continues with the next control statement, if possible (that is, if 
the error does not cause the job to unconditionally abort). Refer to the description 
of exit processing in section 5 for further information. 

NORERUN STATEMENT 

The NORERUN control statement allows a user to clear job rerun status. 

The control statement format is: 
NORERUN. 

If the NORERUN statement has been issued, the job may not be rerun. This may be 
desirable to prevent updating of an important data base when the iob would otherwise 
be rerun. 

This statement is ignored from a time -sharing origin job. 
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NOTE STATEMENT 

The NOTE control statement enables the user to create a file containing lines of data 
entered as a character string on the same line as the control statement. 

The control statement format is: 

NOTEUfn.NIO/linej/lineg/. . . Aine n 

lfn Name of the file which contains the specified lines. Default is 

OUTPUT. 

NR Inhibits rewind of lfn. Default is to rewind the file at the 

beginning and end of NOTE execution. 

/ Delimiting character used to separate the individual entries that 

become lines in the file. It can be any character. It must 
immediately follow a period or right parenthesis. 

line^ A character string which constitutes one line of data in lfn. 

If a file contains more lines than can be entered with a single NOTE statement, a 
series of NOTE statements, each with an NR, can be used. This series should be 
followed with a PACK statement since each NOTE statement writes an EOF. 

Example: ^ 

The following sequence of statements creates a procedure file (PFILE) that can insert 
an input record after any record in an existing master file (LISTFIL). 

NOTE(PFILE, NR)*. PROC, INSERT, N. *GET(LISTFIL)*COPYBR<LISTFIL, NEWLIST, N) 
NOTE(PFILE, NR)*COPYBR(INPUT,NEWLIST)*COPYEI<LISTFIL, NEWLIST) 
NOTE(PFILE,NR)*REPLACE(NEWLIST= LIST FIL) 
PACK(PFTLE) 
SAVE (PFILE) 

To insert an input record after the second record in LISTFIL, the user includes the 
following CCL statement in the job that contains the new input record. 

BEGIN, INSERT, PFILE, 2. 



OFFSW STATEMENT 

The OFFSW control statement clears the pseudo-sense switches for reference by the 
user's program. 

The control statement format is: 

OFFSWtej, s 2 , . . . , s n ) 

s. Sense switch to be cleared; l^s.^6. If s.=0 is specified, all 

sense switches are cleared. l l 

Refer to the description of the ONSW statement for further information on sense switch 
settings. 
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ONEXIT STATEMENT 

The ONEXIT control statement causes the transfer of control to the statement following the 
next EXIT statement Lf an error occurs. 

The control statement format Ls: 
ONEXIT. 

The ONEXIT statement reverses the effect of a NOEXIT statement. If an error occurs Ln 
processing the statement following ONEXIT, control transfers to the statement following 
the next EXIT statement. Refer to the description of exit processing in section 5 for further 
information. 



ONSW STATEMENT 

The ONSW control statement sets the pseudo-sense switches for reference by the user's 
program. 

The control statement format is: 
ONSW( Sl ,s 2 ,...,s n ) 

Si Sense switch to be set; 1< s.< 6. If s L =0 is specified, all sense 

switches are set. 1 

The system stores the sense switch settings in the user's control point area and copies 
them to RA at the beginning of each job step for use by the central program. The sense 
switch field in the control point area and the one in RA are updated separately. 

PASSWOR STATEMENT 

The PASSWOR control statement is used to change the user's password. 
The control statement format is: 

PASSWOR (oldpswd, newpswd) 
oldpswd Old password 

newpswd New password 

The new password must be the minimum length required by the installation. The default 
minimum is 4 characters. 

For added security, the user may issue the PASSWOR statement without parameters. In 
this case, the system reads the parameters from a record in the INPUT file. This record 
must be a single line with the following format. 

oldpswd, newpswd 
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The user's password is changed from oldpswd to newpswd. The user can change his 
password only if access option 1 is set (refer to the LIMITS control statement in this 
section). If option 1 is not set and the user submits a PASSWOR statement, the sys- 
tem issues the following message to his dayfile. 

ILLEGAL CONTROL CARD. 

If the control statement parameters are in error, the system issues the following 
message. 

ERROR IN PASSWOR ARGUMENTS. 

If the installation is currently updating the validation file or another user is modifying his ■ 
password, a nontime-sharing origin job is rolled out until the validation file is available. 
A time- sharing origin PASSWOR command is aborted with the message: 

MODVAL ABORTED. 

If this situation is encountered, the time- sharing user should be able to retry his pass- 
word change within a short time. 

PROTECT STATEMENT 

The PROTECT statement is used to activate or deactivate preservation of a user's ECS 
field length between job steps. 

The control statement format is; 



PROTECT ( j gp F j ) 



or 



PROTECT (EC 



„ ION 
" |OFF 



I' 



The parameter is activated by specifying ON and deactivated by specifying OFF. ECS 
preservation is initially OFF. 

Ordinarily, the ECS field length of a job is zeroed at the completion of a job step. 
With EC=ON, the ECS field length is preserved between job steps. 

The PROTECT statement is available to the user only if option 15 of his access word 
is set (refer to the LIMITS control statement in this section). If option 15 is not set 
and the user submits a PROTECT statement, the system issues the following message 
to his dayfile. 

CPM - ILLEGAL USER ACCESS. 

If no parameters are specified, an illegal keyword is used, or any parameter other than 
ON or OFF is entered, the system issues the following message. 

ERROR IN CONTROL ARGUMENTS. 
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RERUN STATEMENT 

The RERUN control statement allows a user to set job rerun status. 

The control statement format Ls: 
RERUN. 

If the RERUN statement has been issued, the job may be rerun. This statement is ignored 
from a time -sharing origin job. 

RESOURC STATEMENT 

The RESOURC control statement is required in any job that uses more than one tape or pack 
concurrently; it prevents deadlocks with other jobs which may need the same resources. 

The control statement format is: 

RESOURCE =u 1t rt =u , ...,rt =u ) 
i i £ & n n 

r^ Resource type: 

LO 7-track magnetic tape unit 

HI 7-track magnetic tape unit 

HY 7-track magnetic tape unit 

HD 800 cpi. 9-track magnetic tape unit 

PE 1600 cpi, 9-track magnetic tape unit 

GE 6250 cpi, 9-track magnetic tape unit 

MTT 7-track magnetic tape unit 

NTt 9-track magnetic tape unit (800/1600 cpi) 

Dli 844-21 Disk Storage Subsystem (l<i£8) 

DJi 844-41/44 Disk Storage Subsystem (l<i<8) 

DKi 844-21 Disk Storage Subsystem (full track) (l<i<8) 

DLi 844-41/44 Disk Storage Subsystem (full track) (l£i<8) 

DMi 885 Disk Storage Subsystem (half track) (l<i<3) 

DQi 885 Disk Storage Subsystem (full track) (l<i<3) 



u. 



i Maximum number of units of resource type rtj this job will use 

concurrently; any rt^Uj entry can be changed on subsequent 
RESOURC control statements. (Refer to Altering Resource 
Requirements.) An rt=0 entry can be entered to clear a resource 
type that is no longer required. 



T Retained for compatibility with NOS 1. 2. Refer to restrictions described under Tape Units 
in this section. 
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DEADLOCK PREVENTION 

The system manages the use of tape units and disk packs so as to prevent deadlocks from 
occurring. A deadlock means that the system, by assigning a tape unit or pack to one job, 
prevents another job with currently assigned resources from completing. For example, 
an installation with two tape units is processing jobs A and B. Each job needs both units 
during some phase of processing. Job A is assigned unit 1. If job B were assigned unit 2, 
neither A nor B could complete until the other job relinquishes its assigned unit. 

To prevent deadlocks from occurring, the system requires that a RESOURC control state- 
ment be included in any job that uses more than one tape or disk pack concurrently. Thus, 
in the previous example, a RESOURC statement is required in both jobs. The information 
supplied by the statements enables the system to anticipate the deadlock situation and roll 
out job B until job A no longer needs both units. When a job that includes a RESOURC state- 
ment is submitted, the system first checks if the specified number of units exceeds the num- 
ber of units for which the user is validated-)- or the number of units available at the installa- 
tion. If either of these situations occurs, the system issues an error message to the user's 
dayfile and aborts the job. (Refer to figure 1-6-1. ) 




Timed roll 
out of job 



t Refer to description of Resource Overcommitment, 
ft The statements are described in sections 8 and 10. 



Figure 1-6-1. Resource Commitment Processing (Simplified) 



| For jobs that use only one tape or pack at a time and do not contain a RESOURC statement, 
the system checks validation limits when the request is made. 
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When the job requests a tape or pack.t the system compares the number of units that jobs 
being processed have scheduled via RESOURC statements with the number of units actually 
assigned. If it determines that the assignment would cause a deadlock (refer to Resource 
Overcommitment), it rolls out the job until a deadlock would not occur. If the assignment 
would not cause a deadlock, the system searches for the requested tape or pack. If .found 
it is assigned to the requesting job. If the pack is not found and the NA keyword was in- * 
eluded in the request or if the tape is not found, the requesting job is rolled out until the 
operator makes the pack or tape available. 



SINGLE RESOURCE USE 



A job that uses only one tape or disk pack concurrently does not need to specify resource 
demand with a RESOURC statement. However, before assigning the same or a different 
type of resource, the current single resource (tape or disk pack) must be returned with 
either the RETURN or UNLOAD control statement. To allow more flexible resource handling 
both the RETURN and UNLOAD functions decrement the default resource demand count from 

one to zero for iobs reauirinc onlv nip tan? nr Hiat nont ^^^^n^-^^^+i,. w„_ ±i _•_!__ 

requiring more than one tape or disk pack concurrently (as specified by the RESOURC state- 
ment), UNLOAD does not decrement the resource demand count; RETURN decrements the 
resource demand count only when all concurrent resource demands have been satisfied. 



TAPE UNITS 



Density resource identifiers (HD, PE, GE) should be used to indicate 9-track magnetic tape 
unit demand. The system supports 9-track drives with alternate densities and needs this 
information to prevent deadlocks and overcommitments. The 679-2/3/4 tape units are 
capable of processing both 800-cpi and 1600-cpi 9-track tapes; the 679-5/6/7 tape units 
handle both 1600-cpi and 6250-cpi 9-track tapes. An 800-cpi 9-track tape cannot be 
?^ff« ° n a 1600 / 6250 -cpi unit, and 6250-cpi 9-track tape cannot be processed on an 
800/ 1600-cpi unit. The NT resource identifier, retained for compatibility, can be used 
only to allocate 800 /1600-cpi 9-track unitstt and cannot be specified concurrently in the 
same job with HD, PE, and GE resource demands. Default 9-track resource allocation 
is by density. 

Examples: 

An installation has the following tape drive resources: 

• Two 679-4 9-track tape drives (800/1600-cpi densities) 

• Two 679-7 9-track tape drives (1600/6250-cpi densities) 



t Refer to Permanent File Control Statements in section 8 for a description of disk pack 
requests and to Tape Management Control Statements in section 10 for a description of 
tape requests, 
tt NT resource demand cannot exceed the number of 800/1600-cpi 9-track drives at the 
installation. However, at tape assignment time, a 1600-cpi tape mounted on a 1600/ 
6250-cpi unit is accepted for NT resource demand if it does not cause overcommitment 
(potential deadlock). 
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1. If a job makes a tape unit resource request with 

RESOURC(NT=3) 
the job is aborted with the message 

INSUFFICIENT RESOURCES ON SYSTEM 
because only two units (the 679-4s) meet the NT specification. 

2. If a job makes a tape unit resource request with 

RESOURC(NT=l,PE=l) 
iSae job is aborted with the message 

CONFLICTING RESOURCE TYPES, 
because the NT specification cannot be used with a density specification (HD/PE/GE). 

3. If a job contains the following control statements 

LABEL(TAPE,NT,D=PE,VSN=TAPE1) 
RESOURC(NT=2) 

the job is aborted with the message 

CONFLICTING RESOURCE TYPES. 

because the LABEL statement requested a tape unit by density (the default); there- 
fore, later statements cannot schedule tape units using the NT specification. 

Density identifiers are provided for 7-track tape units even though these units do not have 
alternate densities. This is done for consistency of format. The LO, HI, HY, and MT 
resource identifiers are all equivalent, and the last specification of any one of these is the 
7-track tape unit demand for the job. For example, the resource request RESOURC(HI=l, 
HY=2) results in two 7-track tape resources being allocated for the job. 



RESOURCE OVERCOMMITMENT 

Under certain conditions, the system overeommits resources, provided all jobs with cur- 
rently assigned resources can complete. For example, an installation with three tape units 
is processing jobs A and B. Included in each job is a RESOURC statement scheduling two 
units. Job A requests its first tape. It is assigned the tape (unit 1) because there are 
enough units available for job A to complete. Job B requests its first tape. It is assigned 
the tape (unit 2) because either A or B can complete if assigned the last unit, and when the 
job that is assigned the last unit completes, the other can then use that unit and also complete. 
Job B then requests and is assigned its second tape (unit 3). It completes its operations (that 
is, terminates or returns the files on the tape) and makes the unit available for job A to 
complete. 



NOTE 



In a multimainframe environment, only the 
configuration of the machine on which the 
job is processed is considered in the over- 
commitment algorithm. 
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ALTERING RESOURCE REQUIREMENTS. 

The system manages its resources by keeping totals of the number of units of each device 
type scheduled and assigned to jobs. The number of units scheduled and the number of 
units assigned to a job can vary during job processing. 

To change the number of units of a device type scheduled for this jobi the user can issue 
another RESOURC statement. When decreasing the number of units scheduled for the job 
via a RESOURC statement, the total resulting scheduled units must not be less than the 

I number of units currently assigned to the job. If the resulting total would be less than the 
number currently assigned, the system aborts the job with an error message. 

If the job has tape and/or removable pack units assigned to it when it attempts to increase 

I its resource demands, the system determines if the request would cause a deadlock. If it 
would, it aborts the job with an error message. 

| NOTE J 

It is recommended that the user always re- 
turn all units assigned to his job before 
issuing another RESOURC statement to in- 
crease resource demands. This action pre- 
vents a possible deadlock condition resulting 
in job abort. 

The scheduled units can also be decreased by a RETURN statement if the job, at a pre- 
rSliS * une ' concurrently used its maximum scheduled units (refer to the description of the 
RETURN statement in section 7). 

Example: 

The second RESOURC statement increases the number of scheduled disk drives and 
decreases the number of scheduled tape units. 

SA MSJOB(CM50000, T40) 
USER(SJGREEN, WGT, A LTFA M) 
CHARGE(D593,75) 
RESOURC(HD=2) 
LABEL(X,D=HD,VSN=TAPE1) 
LABEL(Y, D=HD, VSN=TAPE2) 
RETURNCX.Y) 
RESOURC(DIl=2,HD = l) 



-EOI- 
UNIT ASSIGNMENT 

The method of assigning units depends on the resource type. For example, all tapes and 
all private disk packs not accessible by alternate users can only be assigned to one job at 
a time. All public packs and those private packs accessible by alternate users are share- 
able, and therefore, can be assigned to several jobs at the same time. 
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On indirect access file requests, the pack is charged to the job in fulfilling its resource 
demand only if the request causes the pack to be mounted. For direct access file re- 
quests, the pack is charged to the job when the first ATTACH of a direct access file 
is made. 

A unit is assigned to a job until the job terminates or all direct access files residing 
on the unit that are assigned to the job are returned. At this point, a tape or a non- 
sharable pack can be dismounted. A sharable pack, however, can be dismounted only 
when there are no files residing on the unit that are assigned to any of the jobs sharing 
the pack. 



j NOTE 



In GET requests for indirect access files, a 
pack is assigned to a job only as long as the 
pack is actually being used (that is, until the 
system retrieves the local copy of the file). 
Therefore, during a series of GET requests, 
the operator may determine that the pack is 
not being used and dismount it. If the user 
has a direct access file on the pack, he can 
avoid this situation by attaching the direct 
access file before issuing the GET requests. 

A single job cannot have more than 36 removable pack devices attached to the job 
concurrently. 



RFL STATEMENT 

The RFL control statement sets the initial running fieLd length for each subsequent job step 
when neither the routine for processing that step nor a loader table specifies a field length 
(refer to Field Length Control in section 3). 

The control statement format is: 

RFL(nnnnnn, mmmm) 

or 
RFL(CM=nnnnnn, EC=mmmm) 

nnnnnn Central memory field length (octal is assumed unless decimal is 

specified by a D suffix or use of the digits 8 or 9). The value is 
rounded up to the nearest multiple of 100g. 

Specifying nnnnnn as removes the effect of the previous RFL state- 
ment and returns the setting of the field length to system control. 

mmmm ECS field length in octal. The value of mmmm is the actual ECS 

divided by 1000 g . 

The parameters may be specified positionally, by keyword, or intermixed positionally and 
by keyword. If intermixed, the positional parameters are evaluated according to their 
position among all the parameters. 

The values of nnnnnn or mmmm cannot exceed the values specified on the last MFL control 
statement or the maximum allowed for the job. 
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Prior to the appearance of the RFL control statement (or SETRFL macro), the system 
determines the field length for each job step, provided no field length is specified by a 
system routine or loader table (refer to Field Length Control in section 3). 

If the field length requested is greater than 377777 8 for CM or 7777 Q for EC, the following 
error message is issued. ° 

CM OR EC REQUEST EXCEEDS MAXIMUM. 



ROLLOUT STATEMENT 

The ROLLOUT control statement suspends job execution and places the job in the rollout 
queue. This releases the control point, central memory, and ECS assigned to the job. The 
user can specify a time period that must elapse before the job is returned. Otherwise, the 
job scheduler usually returns the job to execution when its priority is the highest of the jobs 
in the rollout queue (refer to Rollout Control in section 3). 

The control statement format is: 

ROLLOUT (t) 

t Optional time delay measured in job scheduler delay intervals. The 

delay interval length is set by the installation; the default value is 1 
second. Legal values for t range from to 262 080 (777700 R ) 
intervals. Although the default base is decimal, octal values can be 
specified by a B suffix. Specifying a value containing an 8 or 9 and a 
B suffix is illegal. 

RTIME STATEMENT 

The RTIME control statement requests that the time be read from the real-time clock and 
issued to the dayfile (in seconds). This is the accumulated time since the last system 
deadstart. 

The control statement format is: 

RTIME. 
The dayfile message format is: 

RTIME nnnnnn. nnn SECS. 



SETASL STATEMENT 

The SETASL control statement sets the system resource unit (SRU) limit for an account 
block. An account block is the job step sequence whose execution is charged to an account 
(refer to SRU Limit Control in section 3). The account is specified by the charge and pro- 
ject numbers on a CHARGE statement, or if no CHARGE statement is required, by the user 
number on the USER statement. Each user number and each account has an SRU validation 
limit (refer to the LIMITS and ENQUIRE statements). Except for time-sharing jobs, the 
default account block SRU limit is the smaller of the user number and the account validation 
limits. For time-sharing jobs, the default limit is 64 SRUs. 
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The control statement format is: 

SETASL(s) 

s Maximum number of SRDs allowed for account block execution. 

Although the default base is decimal, octal values can be specified by 
a B suffix on the value. Specifying a value with an 8 or 9 and a 
B suffix is illegal. 

s must be greater than or equal to the current job step SRU limit, t 
and less than or equal to the user's and the account's validation 
limits. Exceptions to this rule are the asterisk (*) and values greater 
than 32 760 (77770g). These exceptions set the account block SRU 
limit to the validation limit. 

If the account block SRU limit is reached during account block execution, the system issues 
an error message and terminates the job (refer to Exit Processing in section 5). 



5ETCORE STATEMENT 

The SETCORE control statement presets each word within the field length. 
The control statement format is: 

SETCORE(p) 
or 

SETCORE(-p) 

p Any of the following: (If a minus sign precedes the parameter p, the 

complement of p is set in core. ) 

£ Fill Characters 



ZERO Zeros (0) 

INDEF Indefinite (1777 0000 0000 0000 0000) 

INF Infinite (3777 0000 0000 0000 0000) 

Each word within the field length is set to p. If p is omitted, the system assumes p=0. 

To preset memory within a load sequence, the user issues a LDSET.PRESET control state- 
ment as described in the CYBER Loader Reference Manual. 



t The job step SRU limit must be lowered in the job before the account block SRU limit is 
lowered. Refer to the SETJSL control statement in this section. 
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SETJSL STATEMENT 

The SETJSL control statement sets the system resource unit (SRU) limit for each subsequent 
job step (refer to SRU Limit Control in section 3), Except for time-sharing jobs, the default 
job step SRU limit is the smaller of the user number and the account validation limits (refer 
to the LIMITS and ENQUIRE statements). For time-sharing jobs, the default job step limit 
is 64 SRUs. Time-sharing users can increment their job step SRU limit to complete job 
step execution (refer to the IAF Reference Manual or the Time-Sharing User's Reference 
Manual). 

The control statement format is: 

SETJSL(s) 

s Maximum number of SRUs allowed for job step execution. Although 

the default base is decimal, octal values can be specified by a B 
suffix on the value. Specifying a value with an 8 or 9 digit and a B 
suffix is illegal. 

, s must be greater than and less than or equal to the current account 

block SRU limitt and the user's and the account's SRU validation 
limits. Exceptions to this rule are the asterisk (*) and values greater 
than 32 760 (77770B). These values set the job step SRU limit at the 
validation limit if the account block SRU limit is set at the validation 
limit. T 

The system issues an error message when the job step SRU limit is reached. A job step 
within a batch job is then terminated (refer to Exit Processing in section 5). In time-sharing 
jobs, the user can increment the SRU limit after receiving the SRU limit message (refer to 
the IAF Reference Manual or the Time-Sharing User's Reference Manual). 

SETPR STATEMENT 

The SETPR control statement allows the user to decrease the CPU priority of a job. 
SETPR (p) 

p Priority, l£p£70 8 ; if p exceeds 70 8 or the maximum priority defined 

for the origin type of the job, it is reduced to that value. 

Upon job initiation, a job is assigned the maximum priority allowed for its origin type. (The 
installation defines these priority values.) If a job's CPU priority is lower than that of other 
jobs, the job is assigned control of the CPU only when jobs of a higher priority do not need it. 



t The account block SRU limit must be raised before the job step SRU limit can be raised. 
Refer to the SETASL control statement in this section. 
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SETTL STATEMENT 

The SETTL control statement sets the CPU time limit for each subsequent job step. Each 
user number is validated for a maximum job step time limit (refer to the LIMITS and 
ENQUIRE control statements). For batch jobs, when the user does not specify a time limit, 
the system sets the limit at the user's maximum validation. For time-sharing jobs, the 
default time limits is 64 CPU seconds. Time- sharing jobs can increment their job step 
time limit to complete job step execution (refer to the IAF Reference Manual or the 
Time-Sharing User's Reference Manual). 

The control statement format is: 

SETTL(t) 

t Maximum number of CPU seconds allowed for job step execution. 

Although the default base is decimal, octal values can be specified by 
a B suffix on the value. Specifying a value with an 8 or 9 digit and a 
B suffix is illegal. 

t must be greater than and less than or equal to the user's 
validated time limit. Exceptions to this rule are the asterisk (*) and 
values greater than 32 760 (77770s). These values set the job step 
time limit at the user's validated time limit. 

The system issues an error message when the job step time limit is reached. A job step 
within a batch job is then terminated (refer to Exit Processing in section 5). In time- 
sharing jobs, the user can increment the time limit after receiving the time limit message. 



STIME STATEMENT 

The STIME control statement requests that the accumulated SRU value for the job be issued 
to the user's dayfile. 

The control statement format is: 

STIME. 
The dayfile message format is: 

STIME nnnnnn. nnn UNTS. 



SUBMIT STATEMENT 

The SUBMIT control statement places a user- supplied job file into the input queue as a 
separate job. SUBMIT can reformat the file according to directives within the file. 

The control statement format is: 

SUBMITdfn, q, NR)c 

lfn Name of the file to be submitted to the system for processing as a 

batch job. 
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q Specifies disposition of job output files (OUTPUT, PUNCH, PUNCHB 

and P8) as follows: 

B Job output is disposed to local batch queue to be printed 

and/or punched at the central site (default value for nontime- 
sharing origin jobs). 

N Job output is discarded at job termination (default value for 
time- sharing origin jobs). 

E Job output is disposed to the remote batch queue for printing 
at a remote batch terminal. 

NR No rewind option; inhibits rewind of file specified by reformatting 

directive cREAD. If omitted, file specified by cREAD directive is 
automatically rewound. 

C Espsne rharaptpr ucorl +n i^on+iF™ > a r».„.u:.. j: j..- ._ j.i_ _ ... 

— --r- -w »— <-n*i^.j i^iuiiuauuig vjuccuvcb in me iiie 

to be submitted (lfn). If omitted, the system assumes c = /. 

The number of deferred batch (LDI, SUBMIT, and ROUTE) jobs that the user can have in 
the system concurrently depends on his validation (refer to the DB field of the LIMITS 
f. ont f o1 s, tatem ent in this section). If this limit is exceeded, an error message is issued to 
the dayfiie, and the SUBMIT statement is not processed. 

F °F SUBMIT t0 P rocess reformatting directives, the first line of the submit file must be a 
cJOB directive. Each line preceded by an escape character is recognized as a reformatting 
directive. The escape character is specified on the SUBMIT statement (/ by default). 
Throughout this description, the letter c. preceding a directive, denotes the escape charac- 
ter. Reformatting directives may be interspersed throughout the submit file as long as 
transparent mode is not in effect. Transparent mode is selected by the cTRANS directive 
and requires that the user observe special rules when inserting subsequent directives into 
the file trefer to description of cTRANS and cNOTRANS directives). 

The system does not process reformatting directives unless the first line of the submit 
file contains the cJOB directive. In addition, the first two statements following the cJOB 
directive (second and third statements of the submit file) must be a job and USER statement, 
respectively. All following information is determined by the user. Thus, the first three 
lines of a submit file to be reformatted should be: 

lnl cJOB 

ln2 jobname, . . . 

In3 USER, . . . 

lnl, ln2, and ln3 are optional line numbers. 

The user can include line numbers on the submit file and specify which line numbers are to 
be removed during reformatting with the SEQ and NOSEQ directives. This is especially 
useful if the submit file contains a BASIC program where line numbers are a requirement 

tJS? \ an S^ a S e - If line numbers are included in a submit file, the file must begin with a 
cJOB directive. & 
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The reformatting directives available are described as follows: 



cJOB 



Indicates that the submit file Is to be reformatted and selects 
the following default reformatting directives. The default 
directives remain in effect until specified otherwise. 



cEOR 
cEOF 
cSEQ 
cNOSEQ 

cPACK 

cNOPACK 

c TRANS 



cNOTRANS 

cSEQ 

cPACK 



(disabled by cTRANS) 
(disabled by cNOSEQ) 
(disabled by cNOPACK) 



The cJOB directive must be the first line of the submit file. 
If omitted, the file is not reformatted. If line numbers are 
included in a submit file, the file must begin with a cJOB 
directive. 

Indicates that an end-of-record mark is to be placed at this 
point in the submit file during reformatting. 

Indicates that an end-of-file mark is to be placed at this point 
in the submit file during reformatting. 

Indicates that the following lines are preceded by line numbers 
and requests that they be removed (default value). 

Reverses the effect of the cSEQ directive. No attempt is. made 
to remove leading line numbers from subsequent lines. This 
is especially useful when line numbers are required (such as 
in a BASIC program). 

Requests that all succeeding end-of-record and end-of-file 
marks be removed (default value). This directive applies 
only to internal EOR and EOF marks that currently exist. 
The cEOR and cEOF reformatting directives are not affected. 

Reverses the effect of the cPACK directive. Requests the 
system not to discard succeeding internal end-of-record and 
end-of-file marks that currently exist. 

Requests transparent mode. In transparent mode, SUBMIT 
ignores reformatting directives until an EOR or EOF mark is 
encountered. The EOR or EOF mark cannot be a mark to be 
created by a cEOR or cEOF directive. SUBMIT performs the 
following procedure for transparent mode processing. 

1. Read c TRANS directive. 

2. Check if the next line is a reformatting directive. 
If it is not, skip steps 3 and 4. 

3. Process reformatting directive. If it is a cNOTRANS 
directive, select nontransparent mode and end 
transparent mode processing. 

4. Return to step 2. 

5. Select transparent mode and read lines until an 
internal EOR or EOF mark is encountered. 

6. If the cPACK directive is in effect, remove the EOR 
or EOF mark. 

7. Return to step 2. 
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The cTRANS directive is typically used in conjunction with the 
cREAD directive. It allows the user to copy the contents of 
an existing file into the submit file at the location of the cREAD 
directive. Because the file is read in transparent mode, no 
check for reformatting directives is attempted until an internal 
EOR or EOF is encountered. The cREAD directive must 
- follow the cTRANS directive and must he located before the 
first succeeding line that is not a reformatting directive. If 
not, transparent mode is selected before the cREAD directive 
is encountered and the cREAD is ignored. 

The cSEQ or cNOSEQ directive in effect before transparent 
mode was selected has no effect upon the submit file or the file 
being read (cREAD) while transparent mode is in effect. 
However, the cPACK or cNOPACK directive in effect before 
transparent mode was selected remains in effect after it is 
selected. 

cNOTRANS Reverses the effect of the cTRANS directive and informs the 

system that the submit file is to be examined on a line-by-line 
basis. All directives encountered in the submit file while the 
cNOTRANS directive is in effect are processed. This direc- 
tive is initially selected by default and remains in effect until 
a cTRANS directive is encountered in the submit file. 

The user should be careful in placing this directive in the 
submit file. If transparent mode is selected, this directive 
can possibly be ignored unless it immediately follows either 
a cREAD directive or an internal EOR or EOF mark. 

cREAD, lfn Requests that the system read the contents of the specified 

file, lfn, and insert that file in place of the cREAD directive 
in the submit file, during reformatting. Reading terminates 
when an EOF or EOI is encountered on lfn. If the file to be 
read is not currently local to the job, the system automatically 
attempts a GET and then an ATTACH on the file. If lfn is not 
specified in the directive, TAPE1 is assumed. If the file 
specified cannot be found, the message 

NO READ FILE - lfn. 

is issued to the user's dayfile, and the job is terminated. If 
the read file is found to be busy (direct access files only), the 
message 

READ FILE BUSY - lfn. 

is issued to the user's dayfile, and the job is terminated. The 
file specified by lfn in the cREAD directive is automatically 
rewound before the read operation unless the NR parameter is 
specified on the SUBMIT control statement. In this case, the 
rewind directive must precede the cREAD directive in the sub- 
mit file if it is desired to rewind file lfn before the read opera- 
tion begins. The system returns all files specified in cREAD 
directives before completion of the job. 

If the cPACK directive is in effect at the time of the read, all 
internal EOR marks are removed. If the cNOPACK directive 
is in effect, all internal EOR marks are read into the submit 
file in the proper position during reformatting. 
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Unless transparent mode is in effect when file lfn is read, 
each line of that file is also checked for a reformatting direc- 
tive. Any directives contained in the file, except another 
cREAD, are processed. The cREAD directive cannot be 
nested. In addition, any directives in effect before the cREAD 
directive is processed remain in effect for the file being read, 
unless transparent mode is selected. Then, only the cPACK 
or cNOPACK directive remains in effect for the file being read. 
Moreover, only those directives that immediately follow an 
internal EOR in the file being read are processed. 

If the file to be read is a binary file, it is recommended that 
the cTRANS directive be used to ensure that binary data is not 
mistaken for a reformatting directive. The cTRANS directive 
should immediately precede the cREAD directive in the sub- 
mit file, if used. 

cREWIND, lfn Requests that the system rewind file lfn to the beginning-of- 

information (BOI). If lfn is not supplied, TAPE1 is assumed. 
This directive is required only if the NR parameter is included 
in the SUBMIT command. Otherwise, file lfn is automatically 
rewound. 

This directive is used in conjunction with the cREAD directive. 
Thus, if it is desired to rewind a file before the read operation 
begins, this directive must precede the cREAD directive in the 
submit file. 

c ; ,EC=c 2 Indicates that the escape code character is to be changed from 

c. (current escape code) to c„ (new escape code). The new 
escape code is used to recognLze all subsequent reformatting 
directives until further change. 

Input lines must not exceed 150 6-bit characters. SUBMIT processes the first 80 charac- 
ters as the control statement. The remaining 70 characters are discarded and may contain 
a sequence number or comments. If a line exceeds 150 characters, the results are 
unpredictable. 

If the submitted job contains an illegal USER statement, the job entering the SUBMIT state- 
ment is aborted (no exit processing). The following messages are issued to the dayfiie. 

ILLEGAL USER CARD. 
SYSTEM ABORT. 

The security count for the user number that entered the SUBMIT statement is decremented, 
and the following message is issued to the account dayfiie. 

SIUN, usernum. 

Terminal users are immediately logged off and no message is issued. The system then 
begins the login sequence (for IAF users) if the security count is greater than zero. For 
further information concerning use of the SUBMIT statement from a time-sharing terminal, 
refer to the IAF Reference Manual or the Time-Sharing User's Reference Manual. 
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The user should consult his job's dayfile to determine the cause of any errors that occurred 
during job processing. The dayfile for the submitted job is disposed to the local batch queue 
or the remote batch queue according to the disposition parameter on the SUBMIT statement. 

When a user submits a batch job image from a time-sharing terminal, all output is dropped 
(unless requested otherwise by the disposition parameter). This includes the dayfile output. 
Therefore, the time-sharing user should make provisions within his job to save the contents* 
of the dayfile if a processing error occurs. This is done by including the following control 
statements at the end of the control statement record. 



Inx 


EXIT. 


lny 


DAYFILE(lfn) 


Inz 


REPLACE(lfn) 



SUI STATEMENT 

statement allows a user to access a permanent file catalog without using 
the USER statement. 

The control statement format is: 
SUI(n) 

n User index desired; 0<n<377777 8 . 

The SUI statement is useful if validation is not active. Only system origin jobs may issue 
this control statement. If the job is not of system origin, the following message is issued. 

CPM-ILLEGAL REQUEST. 

SUMMARY STATEMENT 

The SUMMARY control statement gives information about the system to the user. 
Three forms of the command are allowed. 

The control statement formats are: 

SUMMARY(OP=p 1 p 2 . . . p n , JN=jobname, FN=lfn 1 , 0=lfn 2 ) 

or 
SUMMARY^pg. . . p n ) 

or 
SUMMARY. 

The parameters and function of this control statement are identical with the ENQUIRE 
statement described in this section, except that the third form of the statement 
(SUMMARY.) defaults to the OP- R option. statement 
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SWITCH STATEMENT 

The SWITCH control statement sets the pseudo- sense switches for reference by the user's 
program. 

The control statement format is: 

SWITCH(s 1 , s 2 , ...,s n ) 

s^ Sense switch to be set; 1<S£<6. If si=0 is specified, all- 

sense switches are set. 

Refer to the description of the ONSW statement for further information on sense switch 
settings. 

This control statement performs the same function as the ONSW control statement. 

USECPU STATEMENT 

The USECPU control statement specifies which central processor is to be used when more 
than one is available for processing. 

The control statement format is: 

USECPU(n) 

n = Either central processor is used, 

n = 1 CPU is used, 

n = 2 CPU 1 is used. 

The USECPU statement may be used only when the system is running on a CYBER 73-2x, 
74-2x, 6500, 6700, or CYBER 174 system. On a 74-2x or 6700, CPU is the parallel 
processor, and CPU 1 is the serial processor. On the other systems, both CPUs are serial 
processors. This statement is ignored on single CPU machines. 
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USER STATEMENT 

The system uses the parameters on the USER control statement to determine if a legal user 
initiated the job, which resources he is validated to use, and the extent (limits) to which he 
may use those resources. Comment statements are not allowed between the job and USER 
statements. If this is attempted, the first comment statement is interpreted as an illegal 
USER statement, and the submitting job is aborted with appropriate messages to the dayfile 
The submitted job is dropped. 

The control statement format is: 

USER(usernum, passwrd, familyname) 

usernum A 1- to 7-character alphanumeric user number. 

passwrd Alphanumeric password. Its maximum length is 7 characters; 

its minimum length is defined by the installation. 

familyname Optional parameter identifying the family! of permanent file 

devices that have been or may be transferred from the user's 
norma}/ system to a backup system. 

This statement defines controls and validation limits for the job and defines the user's 
permanent file base. An installation may operate with secondary USER statements either 
enabled or disabled. If enabled, the user may specify a different permanent file catalog 
during job processing by issuing another USER statement. However, the access limits for 
the user named in the first USER statement remain in effect for all subsequent USER state- 
ments (refer to the LIMITS control statement in this section for information concerning 
access limits). If secondary USER statements are disabled (default mode) and a secondary 
USER statement is issued, the job is aborted (no exit processing). The security count for 
the current user number is decremented accordingly, and the following messages are issued 
to the dayfile. 

ILLEGAL USER CARD. 
SYSTEM ABORT. 

In addition, the following message is issued to the account dayfile. 
SIUN, usernum. 

The job is aborted, the security count is decremented, and the preceding messages are 
issued if a USER statement containing an invalid user number is detected at any time, 
regardless of whether secondary USER statements are enabled or disabled. In all cases 
terminal users are immediately logged off with no dayfile message issued to the terminal. 

If the security count for the user is exhausted, the system issues the following message. 

ILLEGAL USER NUMBER - CONTACT SITE OPR. 

When this occurs, the user number is denied all access to the system until the security 
count has been reset by the installation personnel. 

The password is deleted from the USER control statement before this statement is issued 
to the dayfile. 



I t Refer to section 2 for a description of permanent file device families. 
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Normally, the familyname parameter need not be included on the USER statement. How- 
ever, if the user makes a practice of specifying his family name each time he submits a job, 
he can be sure that his job will be processed even if his normal system is not available and 
his permanent file family is moved to a backup system. If, after the first USER statement, 
the user does not specify a familyname on the USER statement, his permanent file family 
remains the same. If the user specifies the (zero) familyname, his permanent file family 
becomes the system default family. 



Example: 

An installation has two systems, A and B. System B provides backup service for system A. 
The system default family name for system A is AFAM, and the system default family name 
for system B is BFAM. 

During normal operations, system A user CWJONES with password JPWD could enter 
either of the following USER statements. 

USER(CWJONES, JPWD) 

USER (CWJONES, JPWD, AFAM) 

System B user JDSMITH with password SPWD could enter either of the following state- 
ments. 

USER(JDSMITH, SPWD) 

USER (JDSMITH, SPWD, BFAM) 

If system A failed, user CWJONES would be required to enter 

USER (CWJONES, JPWD, AFAM) 

to identify his family of permanent file devices. User JDSMITH could enter either of 
the USER statements as before because the default family name would still be valid. 

If the user attempts to access permanent files on a device not present in the alternate 
system, one of the following messages is issued to the user's dayfile. 

DEVICE UNAVAILABLE, AT nnn. This message is issued if the user's 

master device t was not transferred to 
the backup system. 

DIRECT ACCESS DEVICE ERROR, This message is issued if the user 

AT nnn. attempted to reference direct access files 

on a device (other than his master de- 
vice) not present in the backup system, t 



t Refer to section 2 for a description of permanent file device families. 
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FILE MANAGEMENT CONTROL STATEMENTS 



The file management control statements enable the user to manipulate files assigned to his 
job. The control statements included in this category are: 



ASSIGN 


COPYSBF 


PACK 


SKIPFB 


BKSP 


COPYX 


PRIMARY 


SKIPR 


CLEAR 


DISPOSE 


RENAME 


SORT 


COMMON 


DOCMENT 


REQUEST 


TCOPY 


CONVERT 


EVICT 


RESEQ 


TDUMP 


COPY 


FCOPY 


RETURN 


UNLOAD 


COPYBF 


LIST80 


REWIND 


UNLOCK 


COPYBR 


LOCK 


ROUTE 


VERIFY 


COPYCF 


L072 


SETID 


WRITEF 


COPYCR 


NEW 


SKIPEI 


WRITER 


COPYEI 


OUT 


SKIPF 





The statements in this section allow the user to position his files, copy data from one file 
to another, specify method and format of input/output, sort his files, and add correc- 
tions. He can assign his files to a specific device type; change the file type, identi- 
fication code, and write interlock status; and release them from job attachment. The 
user can also receive information about records in a file or documentation in a file 
containing COMPASS source code. 

If an error is encountered in an operation on one file of a multiple file request, the 
operation is not performed on the following files. For example, if an error occurs in 
processing file B on the following control statement: 

GET(A,B,C,D) 
files C and D are not processed. 

If a file is not specifically assigned through the use of an ASSIGN, LABEL, or 
REQUEST control statement, the system assigns the file to available mass storage. 
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ASSIGN STATEMENT 

The ASSIGN control statement directs the system to assign a file to the specified device 
or device type. The following descriptions refer to devices other than magnetic tape. 
For use of the ASSIGN statement with magnetic tape, refer to section 10. 

The control statement format is: 

ASSIGN(nn, lfn, {£|}) 

nn Device or device type to which the specified file is to be 

assigned; nn may be either the EST ordinalf of a peripheral 
device, or the device type as defined as follows: 

Type Equipment 

DE Extended core storage 

DI 844-21 Disk Storage Subsystem {half track) 

DJ 844-4x Disk Storage Subsystem (half track) 

DK 844-21 Disk Storage Subsystem (full track) 

DL 844-4x Disk Storage Subsystem (full track) 

DM 885 Disk Storage Subsystem (half track) 

DP Distributive data path to ECS 

DQ 885 Disk Storage Subsystem (full track) 

MS Mass storage device 

NE Null equipment 

TT Time-sharing terminalstt 

lfn Name of the file to be assigned to the specified equipment 



| Contact installation personnel for a list of EST ordinals. 
ff This device type applies only to time-sharing origin jobs. 
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Example 1: 

ASSIGNCMS, OUTPUT) 

This statement assigns file OUTPUT to mass storage. With this assignment, a time-sharing 
user causes output normally printed at his terminal to be written on a mass storage file 
instead. Here, output means information generated by a program during execution. Day- 
file messages are still printed at the terminal. Once this assignment is made, output is 
written on the mass storage file OUTPUT until the file is returned or reassigned. 

Example 2: 

ASSIGN(TT, XYZ) 

This statement assigns file XYZ to the user's time-sharing terminal. The assignment 
means that input that the system would have read from file XYZ is instead solicited by a 
prompt at the terminal and that output that the system would have written on file XYZ is 
instead displayed at the terminal. 

Example 3: 

ASSIGNCDI, ABC) 

This statement assigns file ABC to an 844-21 Disk Drive, if one is available. 

The ASSIGN statement can also be used to create or access existing 7- or 9-track unlabeled 
tapes. For a description of the statement as it applies to magnetic tape assignment, refer 
to Tape Management in section 10. 



BKSP STATEMENT 

The BKSP control statement directs the system to bypass a specified number of logical 
records in the reverse direction. 

The control statement format is: 

BKSPOfn, n, m) 

lfn Name of the file to be backspaced. 

n Number of logical records (decimal) to backspace; if this 

parameter is omitted, the system assumes n=l. 

m File mode: C for coded, B for binary. If omitted, the system 

assumes the file is in binary mode. 
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The BKSP request can be issued at any point in a logical record. If, for example, FILE1 
were positioned within the third record, a 

BKSP(FILEl) 

request would reposition FILE1 to the beginning of the third record. The system does not 
backspace past the beginning-of-information (BOl) or load point (tape file). However, EOF 
indicators are considered separate records and are included in the record count. An 
unrecognizable record count causes the message 

ERROR IN FILE ARGUMENTS. 

to be issued to the user's dayfile. 

The BKSP statement has no effect on a primary file since that file is rewound before every 
operation. 



CLEAR STATEMENT 

The CLEAR control statement releases all files currently assigned to the job. The user 
can also specify files that are not to be released. 

The control statement formats are: 

CLEAR. 

or 

CLEAR(*. lfn, , lfn . .... lfn J 
\ £ n 

The first format releases all files. The second format releases all files except those 
named. If no files are named, all files assigned to the job are released. 

Refer to RETURN statement in this section for the operations performed on each file type. 

A CLEAR control statement should not be used in a CCL procedure because it returns the 
CCL working files. Further processing of the procedure produces unpredictable results. 



COMMON STATEMENT 

The COMMON control statement creates or accesses a library type file (LIFT). 
The control statement format is: 
COMMON (If nj, lfn 2> . . . , lfn n ) 

lfn Logical file name. 
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The user must be validated to access or create library files. The specified file must be 
a local mass storage file. If Ifn is not local, a search is made for a library file by that 
name, and an error message is issued if the file is not found. If the operation completes 
successfully, the file is attached to the user's job as a library type file. 

Before a local file can be made a library file, it must be locked. Refer to LOCK 
Statement in this section. 



CONVERT STATEMENT 

The CONVERT control statement converts records from one character set to another. 

The control statement format is: 

CONVERT^, p 2> . . . , pj) 

p. May be one of the following. 

P=lfn. Input on file lfn-; if omitted, file OLD is assumed. 

N=lfii2 Output on file lfn 2 ; if omitted, file NEW is assumed. 

RS=n- Maximum record size in characters (decimal); 

1 £ n ^ 500. If omitted, 300 is the assumed maxi- 
mum record size. (Each character is 6 bits, ) 

64 Convert from 63- to 64-character set; if omitted, no 

conversion takes place. The TS option must be 
specified if 64 is not. 

TS=t Convert from old time-sharing 61-character set to new 

time- sharing 6 3- character set; t may be one of the 
following terminal types. 

t Terminal Type 

TTY ASCII code terminal with standard 

print. 
COR Correspondence code terminal 

with standard print. 
CORAPL Correspondence code terminal 

with APL print. 
MEMAPL Memo rex 1240 (ASCII code) 

terminal with APL print. 
BLKEDT Block transmission (ASCII code) 

terminal with full display screen 

editing capability and standard 

print. 
NAMIAF Virtual network terminal. Same 

as TTY. 

If t is omitted, it is assumed to be TTY. If TS is 
omitted, no time-sharing conversion takes place. The 
64 option must be specified if TS is not. 



R Rewind input and output Tiles prior to processing, 

omitted, no rewind takes place. 



If 
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RC=n„ 



NM 



Conyert no decimal records. If 112 is omitted, convert 
until an EOF is encountered. If RC is omitted, one 
record is assumed. 

Used in conjunction with TS parameter and specifies 
that conversion is to normal mode; if omitted, conversion 
is to ASCII mode. Note the effect of conversion on the 
following characters. 

A (circumflex) If TS is specified, display code 70 
(circumflex character) is converted 
to 76. If NM is omitted, conversion 
is to 7402 (ASCII mode). 

: (colon) If TS and 64 are specified, display- 

code 63 (colon character) is con- 
verted to 00. If NM is omitted, 
conversion is to 7404 (ASCII mode). 

The following lists legal conversion using the appropriate CONVERT parameter. 



Type of Record 

63-character set, nontime- sharing record 
Old time- sharing record 

New NORMAL time- sharing record 
(equivalent to BATCH character set) 

New ASCII time- sharing record 



Legal Conversion Parameters 

64 

TS or 

64 and TS 

64 
None 



COPY STATEMENT 

The COPY control statement copies data from one file to another if the files are within the 
range of permissible formats listed in table 1-7-1. 

TABLE 1-7-1. RANGE OF PERMISSIBLE FORMATS FOR THE COPY STATEMENT 

Output 



Input 
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The parameters can appear in order-dependent format, order-independent format, or a 
combination of both. The completely order-dependent format is: 

COPY(lfn., lfn 2 ,x, c, tc, copycnt, bsize, charcnt, erlimit, PjPo* • • P n > ^ n ^ 

The completely order- independent format is: 

COPY(I=lfn 1 ,0=lfn„, V=x, M=c, TC=tc,N=copycnt, BS=bsize, CC=charcnt, EL=erlimit, 
PO=p 1 P 2 - . . p n , L=lfn 3 ) 

If order -dependent and order- independent parameters are mixed in one COPY statement, 
the order- dependent parameters must appear in their proper position. All parameters are 
optional. However, the specification of certain parameters precludes the application of 
others. A nonapplicable parameter maybe ignored or it maybe illegal. This is stated in 
the individual descriptions of the parameters. 



The parameters are defined as follows: 

Parameter Description 

I=lf n- Name of the file to copy from. 

0=lfn- Name of the file to copy to. 

V=x If the x parameter (1 to 7 alphanumeric 

characters) is present, both files are 
rewound, copied, rewound, verified, and 
rewound. The x parameter must not be 
zero. 



Default 



INPUT 
OUTPUT 
No verify 



M=c 



TC=tc 



M=C1 Coded mode is set on input 

only. 

M=C2 Coded mode is set on output 

only. 

M=any other value (1 to 7 alphanumeric 
characters) 

Coded mode is set on both 
input and output. 

This parameter applies only to S and 
L format tapes. If coded mode is set 
on an SI tape, the system aborts the job. 
For other formats, the system ignores 
the mode setting. 

Specifies the copy termination condition 
used in conjunction with N=copycnt. 
The termination condition can be specified 
as follows: 



Binary 



Copy to double EOF 
(TC=D or TC=EOD) 
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Parameter 



Description 



Default 



N=copycnt 
BS=bsize 



CC=charcnt 



EL=erlimit 



is. 

F or 
EOF 

I or 
EOI 

D or 
EOD 



Meaning 

The N keyword specifies the 
number of files to copy. 

Copy to the end of information. 
The N keyword is ignored. 

The N keyword is the number 
of double EOFs to copy to. 
If N > 1 is specified together 
with this TC value, and 
verify is also selected, the 
files are verified only to the 
first empty file (COPY calls 
VERIFY with N=0 parameter). 

Copy count used with the copy termination 
condition specified by the parameter TC. 

Maximum block size (in central memory 
words) which specifies S or L tape PRU 
size. This applies only when copying 
to or from S and L tapes. It cannot be 
specified with the CC parameter. 

Maximum number of characters in an 
S or L tape block. This parameter can 
be specified only when copying to or from 
S and L tapes. The PRU size and unused 
bit count are calculated from the charac- 
ter count. However, the unused bit count 
is used only when writing a full block to 
an S or L output tape during a copy from 
mass storage, I, or SI format tape. 
The charcnt value should be a multiple 
of 10. If it is not, the characters that 
exceed the charcnt value in the last word 
of the record are discarded when writing 
an S or L format tape. This parameter 
cannot be specified with the BS parameter. 

Error limit which specifies the number 
of nonfatal errors allowed before abort. 
This includes both parity errors and 
block-too-large errors which are re- 
turned by the tape subsystem after com- 
pleting recovery procedures. If EL=U 
is specified, unlimited error processing 
is allowed. Error recovery is supported 
on mass storage and on ail tape formats 
but is not supported on a terminal or on 
unit record equipment. In the latter 
cases, any error aborts the job. 



If CC is not specified, 
1000B for S tape copy 
and 2000B for L tape 
copy. 



Not used (the PRU size 
is specified by the BS 
parameter) 



Zero 
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Parameter 



Description 



Default 



PO= Pl P 2 ...p n 



L=lfn„ 



One or more of the following processing 
options: 

E Input blocks with parity errors or 

block-too- large errors are 
processed (copied) . 

D Any noise blocks generated by a 

copy from mass storage, I 
format tape, or SI format tape 
to an S or L format tape are de- 
leted. This parameter cannot 
be specified on any other type 
of copy. 

R Allows record splitting during a 

copy from mass storage, I 
format, or SI format to S or L 
format tape. This parameter 
cannot be specified on any other 
type of copy. 

M Copy files according to the copy 

termination condition specified 
by the keyword TC, eliminating 
each EOF on output. This option 
is primarily for use with labeled 
S and L output tapes since it 
eliminates the conflict of the 
double meaning of a tape mark 
on these formats (the tape mark 
on these formats serves as both 
an EOF and label group delimiter). 

Name of an alternate output file to receive 
parity error messages when extended error 
processing is in effect (nonzero EL speci- 
fied), in which case, the file name lfn„ 
must not be the same as lfn- or lfn„. 



Example: 



Error blocks are 
skipped. 



For S or L binary 
tapes, noise blocks are 
padded to noise size 
with binary zeros; for 
coded mode, they are 
padded with blanks. 



Record splitting is not 
allowed. 



Copy files according to 
specification of the 
copy termination (TC), 
writing an EOF after 
each file on output. 



OUTPUT 



The following COPY statement combines order- dependent and order- independent 
parameters. 

COPY(FILEl, FILE2. VERIFY, CODED, EOF, 6, L=MYOUT, PO=E, EL=10) 

FILE1 is the input file, and FILE2 the output file. Six coded files are copied and 
verified. Up to 10 nonfatal errors are allowed, and the bad data is copied with informa- 
tive error messages written to the file MYOUT. 
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The copy statement begins a copy operation at the current position of both files unless the 
verify option is specified. If verify is specified, both files are rewound before the copy 
begins and rewound, verified, and rewound again after the copy is completed. (This verify 
may not be meaningful if the logical structure of the two files is incompatible. ) 

| Copy Termination 

Copying continues until the copy termination condition is met or EOI is encountered. The 
copy termination condition can be a file count, a double EOF count, or EOI. If the copy is 
terminated by a double EOF (for TC=EOD option), the second EOF is detected on Ifn. but 
is not transferred to lfn„. If Ifn^lf^ the named file is read until the termination condi- 
tion is satisfied or EOI is encountered. 

If a copy specifies a file count, TC=EOF, and EOI is encountered on the input file before the 
file count is satisfied, an additional EOF is written on the output file only if data or records 
have been transferred since the previous EOF was written (or since the beginning of the 
copy if no EOFs have been encountered). 



| Block Sizes 

Both L and F tapes may require additional field length to accommodate their maximum block 
size. The maximum block size for an L tape copy is specified either by the BS=keyword 
(or its default), or it is calculated from the CC=keyword. The maximum block size for an 
F tape is determined by the maximum frame or character count specified when the file was 
assigned. The more accurate the selection of these values which determine block size, the 
less are the requirements for field length, CPU time, and I/O time. 

| Processing Options 

The PO=D option specifies noise block processing, and the PO=R option specifies record 
splitting for copies from mass storage, I format, or SI format to S or L format tapes. Due 
to the incompatibilities between the 'logical structure of the input and output files, records 
may be encountered on the input file that are too small or too large to be copied directly to 
the S or L output tape. If the output file block size is less than noise block size, it is 
deleted if PO=D is specified. If PO=D is not specified, the block size is rounded to the word 
multiple of noise size with binary zero fill for a binary S or L tape or with blank fill for a 
coded S or L tape. Empty records on the input file are skipped since they cannot exist on 
an S or L tape. If PO=R is specified and an input file record length exceeds the S or L tape 
maximum block size (the PRU size as specified by BS= or its default, or by CC=), it is split 
into multiple blocks. If PO=R Ls not specified and an input record length exceeds the S or 
L tape maximum block size, the job aborts with the message 

RECORD TOO LARGE ON lfn. 

The PO=M option makes it possible to copy a multifile file to a labeled S or L format tape 
without writing the EOF tape marks. This avoids the conflict of a tape mark serving the 
double purpose of defining an EOF and delimiting a label group on S and L format tapes. 
This is in keeping with the tendency in the computer industry to define a tape mark only as 
a label delimiter. 
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The EL and PO=E options provide extended error processing. If EL is set to a value ' 
greater than zero, a parity error or a block -too -large error on the input file generates the 
following message on the alternate output file. 

PARITY/BLOCK TOO LARGE ERROR IN BLOCK n. 

n is the decimal block count of the block in error. 



COPYBF STATEMENT 

The COPYBF control statement copies a specified number of binary files from one file to 
another. 



| NOTE | 

The COPYBF statement produces unpredictable 
results when copying S, L, and F format tapes. 
The COPY utility is recommended for copying 
tapes in these formats. 



The control statement format is: 

COPYBF(lfn r Ifry n. c) 

Iftij Name of the file to copy from; if this parameter is omitted, file 

INPUT is assumed. 

Ifrig Name of the file to copy to; if this parameter is omitted, file OUTPUT 

is assumed. 

n Number of files (decimal) on lfn. to copy; if this parameter is omitted, 

n=l is assumed. 

c If a fourth parameter (1 to 7 alphanumeric characters) is present, the 

copy to or from an S or L format/tape is performed in coded rather 
than binary mode. If coded mode is set on an SI tape, the system aborts 
the job. For other formats, the system ignores the mode setting. 

The copy begins at the current position of lfn 1 . If lfn. =lfn_, the file is read until the file 
count is satisfied or EOI is encountered. i & 

If EOI is encountered on lfn x before the file count is satisfied, an additional EOF is generated 
on lfn2 only if data or records have been transferred since the previous EOF was written 
(or since the beginning of copy if no EOFs have been encountered). 
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COPYBR STATEMENT 

The COPYBR controL statement copies a specified number of binary records from one file 
to another. 



| NOTE | 

The COPYBR statement produces unpredictable 
results when copying S, L, or F format tapes. 
The COPY utility is recommended for copying 
tapes in these formats. 



The control statement format is: 

COPYBR(lfn 1( Ifr^.n.c) 

lfn. Name of the file to copy from; if this parameter is omitted, file INPUT 

is assumed. 

lfn„ Name of the file to copy to} if this parameter is omitted, file OUTPUT 

is assumed. 

n Number of records (decimal) to copy; if this parameter is omitted, 

n=l is assumed. 

c If a fourth parameter (1 to 7 alphanumeric characters) is present, the 

copy to or from an S or L format tape is performed in coded rather than 
binary mode. If coded mode is set on an SI tape, the system aborts the 
job. For other formats, the system ignores the mode setting. 

The copy begins at the current position of lfnj. EOF indicators are considered separate 
records and are included in the record count. If Ifn. =lfn_, the file is read until the record 
count is satisfied or EOI is encountered. 

If EOI is encountered on lfnj before the record count is satisfied, an additional EOR is 
written on lfn«j only if data has been transferred since the previous EOR or EOF was written 
(or since the beginning of the copy if no EORs or EOFs have been encountered). 



COPYCF STATEMENT 

The COPYCF control statement copies a specified number of coded files from one file to 
another. A coded file is defined as a file containing lines of 150 characters or less, each 
terminated by a zero byte (12 zero bits in the lowest byte of a word). 
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I NOTE | 

The COPYCF statement produces unpredictable 
results when copying S, L, or F format tapes. 
The COPY utility is recommended for copying 
tapes in these formats. 

The COPYCF statement cannot copy SI format 
tapes. If coded mode is set for an SI tape, the 
system terminates the job. The TCOPY utility 
converts SI coded tape files. 



The control statement format is: 

COPYCF ( If n - , If n„ , n, fchar , Ichar ) 

lfn 1 Name of the file to copy from; if this parameter is omitted, file INPUT 

is assumed. 

lfn_ Name of the file to copy to; if this parameter is omitted, file OUTPUT 

is assumed. 

n Number of files (decimal) to copy; if this parameter is omitted, n=l is 

assumed. 

fchar First 6-bit character position of each line to copy; if this parameter is 

omitted, fchar =1 is assumed. 

Ichar Last 6-bit character position of each line to copy; if this parameter is 

omitted, Ichar =136 is assumed. 

The copy begins at the current position of Ifnji . If lfn 1 =lfn 2 , the file is read until the file 
count is satisfied or EOI is encountered. If EOI is encountered before the file count is 
satisfied, an EOF is written on lfn 2 , and the operation terminates. If a line is encountered 
that has more than Ichars, the excess characters are truncated. 

COPYCF writes lines with an even number of characters. If an input line has an odd charac- 
ter count and the last character is a blank not immediately preceded by a colon, the last 
character is removed. If an input line has an odd character count and the last character is 
not a blank or is a blank immediately preceded by a colon, an additional trailing blank is 
appended. 

If Ichar is less than fchar, Ichar is greater than 150, or either fchar or Ichar is unrecog- 
nizable, the following error message is issued to the user's dayfile. 

ILLEGAL CHARACTER NUMBER. 

If COPYCF is attempted on a line longer than 150 (6-bit) characters, the following message 
is issued. 

NO LINE TERMINATOR. 
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COPYCR STATEMENT 



The COPYCR control statement copies a specified number of coded records from one file 
to another. A coded record contains lines of 150 characters or less, each terminated bv a 
zero byte (12 zero bits in the lowest byte of a word). 



The COPYCR statement produces unpredictable 
results when copying S, L, or F format tapes. 
The COPY utility is recommended for copying 
tapes in these formats. 

The COPYCR statement cannot copy SI format 
tapes. If coded mode is set for an SI tape, the 
system terminates the job. The TCOPY utility 
converts SI coded tape files. 



The control statement format is: 

COPYCR (If n r lfn 2 . n.fchar, Ichar) 

lfnj Name of the file to copy from; if this parameter is omitted, file INPUT 

is assumed. 

lfn 2 Name of the file to copy to; if this parameter is omitted, file OUTPUT 

is assumed. 



n 



Number of records (decimal) to copy; if this parameter is omitted 
n=l is assumed. 



fchar First 6-bit character position of each line to copy; if this parameter is 

omitted, fchar =1 is assumed. 

Ichar Last 6-bit character position of each line to copy; if this parameter is 

omitted, lchar=136 is assumed. 

The copy begins at the current position of Ifn,. If lfn^lfn.,, the file is read until the record 
count is satisfied or EOI is encountered. EOF indicators Ire considered separate records 
and are included m the record count. If the EOI is encountered before the record count is 
satisfied, an EOF is written on lfn 2 , and the operation terminates. COPYCR is processed 
in exactly the same manner as the COPYCF control statement except ^thatn specif S T the 
number of records rather than the number of files. specines tne 

is Ssued^ ^ attempted on a line lon 2 er ^^ 150 ( 6 " bit > characters, the following message 
NO LINE TERMINATOR. 



1 " 7 " 14 60435400 J 



COPYEI STATEMENT 

The COPYEI control statement copies one file to another. 



NOTE 



The COPYEI statement produces unpredictable 
results when copying S, L, or F format tapes. 
The COPY utility is recommended for copying 
tapes in these formats. 



The control statement format is: 
COPYEKlfnj.lfn^x.c) 

Ifnj Name of the file to copy from; if this parameter is omitted, file 

INPUT is assumed. 

lfn„ Name of the file to copy to; if this parameter is omitted, file 

OUTPUT is assumed. 

x If a third parameter (1 to 7 alphanumeric characters) is present, 

both files are rewound before the copy, and rewound, verified, 
and rewound again after the copy is complete. 

c If a fourth parameter (1 to 7 alphanumeric characters) is present, 

the copy to or from an S or L format tape is performed in coded 
rather than binary mode. If coded mode is set on an SI tape, the 
system aborts the job. For other formats, the system ignores 
the mode setting. 

The copy begins at the current position of lfnj and continues until the EOI is encountered. 

The EOI is not defined for certain tape formats (refer to table 1-2-1). | 

If lfn.=lfn 2 , the file is read until EOI is encountered. 
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COPYSBF STATEMENT 

The COPYSBF control statement enables the user to copy a file where the first character of 
each line is not a printer control character and is to be printed. 



| NOTE 



The COPYSBF statement produces unpredictable 
results when copying S, L, or F format tapes. 
The COPY utility is recommended for copying 
tapes in these formats. 

The COPYSBF statement cannot copy SI format 
tapes. If coded mode is set for an SI tape, the 
system terminates the job. The TCOPY utility 
converts SI coded tape files. 



The control statement format is: 
COPYSBF(lfn r lfn 2 ,n) 

lfn 2 Name of the file to copy from; if this parameter is omitted, file INPUT 

is assumed. 

lfn 2 Name of the file to copy to; if this parameter is omitted, file OUTPUT 

is assumed. 

n -Number of files (decimal) to copy; if this parameter is omitted, n=l is 

assumed. 

T u h -l COPYS ?T. routine copies n files beginning at the current position of lfn, to file lfno 
shifting each line image one character to the right and adding a leading space. Each line 
image may contain up to 150 (6-bit) characters. Any characters beyond 150 are lost A 
page eject character is inserted at the beginning of each logical record (refer to appendix I 
for a list of carriage control characters). If lfn^lfn.,, n files are skipped but no data 
transfer occurs. If the EOI is encountered before the file count is satisfied, an EOF is 
written to lfn 2> and the operation terminates. 

If COPYSBF is attempted on a line longer than 150 (6-bit) characters, the following message 
is issued. ° = 

NO LINE TERMINATOR. 
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COPYX STATEMENT 

The COPYX control statement enables the user to specify certain conditions when copying 
logical records. 



NOTE 



The COPYX statement produces unpredictable 
results when copying S, L, or F format tapes. 
The COPY utility is recommended for copying 
tapes in these formats. 



The control statement format is: 

COPYXdftij, lfn 2 , x, b, c) 

Ifnj Name of the file to copy from; if this parameter is omitted, file INPUT 

is assumed. 

If ru Name of the file to copy to; if this parameter is omitted, file OUTPUT 

** is assumed. 

x Copy specifications; if omitted, one record is copied. The value for x 

may be one of the following: 

x , Meaning 

n Number of records (decimal) to copy. 

00 Copy all records up to and including first zero-length 

record. 

name Copy all records up to and including record of speci- 

fied name (record name is first 7 characters of 
record or the name in the prefix table, if present). 

type/name Copy all records up to and including record of speci- 
fied type and name (refer to Library Record Types 
in section 14 for list of valid record types). 

b Backspace control; if omitted, is assumed. 

b. Meaning 

No backspace. 

1 Backspace file lfn 1 one record after copy completes. 

2 Backspace file lfn, one record after copy completes. 

3 Backspace files lfn- and lfn„ one record after copy 
completes. 

c If a fifth parameter (1 to 7 alphanumeric characters) is present, the 

copy to or from an S or L format tape is performed in coded rather 
than binary mode. If coded mode is set on an SI tape, the system aborts 
the job. For other formats, the mode setting is ignored. 
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The COPYX routine copies logical records from Ifnj to file lfn2 at the current position of 
Ifnj until the condition specified by x is met. It then backspaces the files according to the 
value specified by the b parameter. If an EOF or EOI is encountered on lfn. before the 
condition specified by x is met, the operation terminates and the backspace parameter b is 
ignored. If lfn 1 = lfn 2 , the file is read until the termination condition is satisfied or an EOF 
or EOI is encountered. 

If EOI is encountered on tfn 1 before the termination condition is satisfied, an additional EOR 
is written on lfn 2 only if data has been transferred since the previous EOR was written (or 
since the beginning of the copy if no EORs have been encountered). 

DISPOSE STATEMENT t 

The DISPOSE control statement releases the specified files to the named output queues. 

The control statement format is: 

DISPOSE(lfn 1 =q r lfn 2 =q 2 , .... lfn n =q n /ot=usernum) 

Ifm Name of the file to be disposed, lfn cannot be a direct access file or 

the primary file. 

i Queue type: 

PR Print 

PH Punch coded 026 

P.9 Punch coded 029 

PB Punch binary 

P8 Punch 80- column binary 

°t Origin type to which files are to be disposed: 

BC Local batch 

EI Remote batch 

usernum Number of the remote batch (that is, ot is EI) user to which the 
files are to be disposed (ignored if ot is BC). This parameter 
is valid only if the user is allowed deferred batch jobs. Also, 
usernum must match the number of the user performing the 
DISPOSE on all character positions except those containing an *. 

The file type for file lfn i is changed to q in the FNT/FST entry for lfn.. The system 
then processes the file according to queue type. The user can dispose coded punch 
files to either 026 or 029 regardless of the job's initial keypunch mode. If the system 
cannot recognize q., the following message is issued. 

ILLEGAL DISPOSE CODE. 

If the ot and usernum parameters are not specified, a remote batch job disposes the 
files to the remote terminal from which it was submitted, and all other origin types 
dispose the files to the central site output device. If ot is BC, the usernum param- 
eter is ignored, and the files are disposed to the central site device. 



f The user should employ the ROUTE control statement for this operation. 
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DOCMENT STATEMENT 

The DOCMENT control statement .enables the user to extract either the external or 
internal documentation from a file containing COMPASS source code. 

The control statement format is: 

DOCMENT( Pl , p 2 , . . . , p n ) 

p. The parameters can be in any order and must be in one of the 

1 following forms. 

Omitted The first default value is assumed. 

a The alternate default value is assumed. 

a=x x is substituted for the assumed value. 

Any numeric parameter can be specified with a postradix character of either B or D. 
The values that p. can assume are: 

I=lfni Name of the file that contains the page footing information; 

this must be a single statement in the following format. 

Column(s ) Contents 





L 


Blank 




2- 


-45 


Document title 


46- 


•55 


Publication number 


56- 


■60 


Revision 


level 


61- 


•70 


Revision 


date 



S=lfn2 Name of the file containing the source statement images from 

which to extract the documentation. This file is rewound by 
default unless the NR parameter is specified. 

L=lfng Name of -the file on which the output is to be written. 

N=nn Number of copies to be produced. 

T=type Documentation type: 

INT Internal documentation (detailed description of the 

internal features of the software). 

EXT External documentation (detailed description of the 

external features of the software). 

C=cc Key character for documentation. 

P=pp Number of print lines per page. 

NR Disable rewind on the S (source) file. 

NT Negate table generator. 

TC List table of contents. 
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The following are the default values for the parameters described. 

Comment 



Parameter 


First 
Default 


Alternate 
Default 


I 





INPUT 


S 


COMPILE 


SOURCE 


L 


OUTPUT 


OUTPUT 


N 


1 


1 


T 


EXT 


INT 


C 


-o 


03 


P 


60 


80 


NR 


REWIND 


NO REWIND 


NT 


ON 


OFF 


TC 


OFF 


ON 



Refer to appendix I in volume 
followed. This appendix also 
for a sample program. 



Page footing information; if I is 0, 
no footing information is printed. 

Source statement images. 

List file. 

Number of copies (decimal). 

Documentation type. 

Check character (two octal digits). 

Number of print lines Der nape. 

a. * o - - 

Source file rewind status. 

Table generator status. 

Table of contents status. 

2 for a detailed explanation of the documentation standards 
contains an example of external and internal documentation 



EVICT STATEMENT 

m!^L7Tto l ^tr at releases fiIe space for the specified files but does not release 

The control statement format is: 
EVICT (lfn r lfn 2 , . . . , lfn Q ) 



lfn. 



Name(s) of the file(s) to be evicted. 



The operation that EVICT performs depends on the file characteristics. 



File 
Permanent file 

Deferred routed 
queue filef 

File with write 
interlock set 

All other files 



EVICT Action 

Releases all file space except the first track and writes an EOI 
on the first sector of the first track, but keeps file assigned to job. 

Releases all file space and clears all file routing information. 
Unloads file. 

Writes file length on first sector of first track and releases file 
space, but keeps file assigned to job. 



t Refer to the ROUTE statement in this section. 
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An EVICT of a tape file performs the same function as an UNLOAD and so cannot be used 
to decrease the number of resource units scheduled via the RESOURC statement. 



FCOPY STATEMENT 

The FCOPY control statement converts a file from one code set to another. Currently, the 
only supported conversion is from 6/12 display code {used in time-sharing ASCII mode) to 
12-bit ASCII code. Refer to appendix A for code set definitions,' 

The control statement format is: 

FCOPY(P4fn 1 ,N=lfn 2 ,PC=cs 1 ,NC=cs 2 ,R) 

P=lfn. File to be converted (default is OLD). The user should assign Ifn. to 

the job before performing the FCOPY operation. 

N=lfn„ File on which the converted data from Ifnj is written (default is NEW). 

If lfn„ is not assigned to the job, FCOPY creates it. 

PC=cs 1 Code set of Ifnj. The default and only current supported value for cs- 

is ASCII, which refers to 6/12 display code. 

NC=cs„ Code set of Ifr^. The default and only currently supported value for 
cs 2 is ASCII8, which refers to 12-bit ASCII code. 

R If R is specified, Ifn^ and ling are rewound before and after the con- 

version. If R is omitted, lfn., and lfn_ are not rewound before or after 
the conversion. ^ 

FCOPY reads Ifnj to its EOI, preserving its EOR and EOF marks on the converted file. 
The maximum line length that can be processed is 160 12-bit codes or 320 6-bit codes. 
Lines that exceed the maximum length are truncated. 



NOTE 



If lfrij is written in 6/12 display code based on the 
63-character set, it must be converted to the 64- 
character set by the CONVERT control statement 
before its conversion by the FCOPY statement. 



Files converted to 12-bit ASCII code can be listed on a local batch printer (refer to the 
ROUTE control statement) but cannot be listed at a time-sharing or remote batch terminal. 

Example? 

A time-sharing user wants to print a file (FILED created in ASCII mode. To do so, he 
enters a COPYSBF statement to prefix the file lines with appropriate carriage control 
characters. He then enters an FCOPY statement to convert the file containing 6/12 display 
code (FILE2) to a file containing 12-bit ASCII code (FILE3). Finally, he routes the con- 
verted file (FILE3) to a line printer that prints the ASCII graphic 95-character set. 
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/ascii 

/copy,file1 . 
AaBbCcDdEeFfGg 
HhliJjKkLlMmNn 

EOI ENCOUNTERED. 
/rewind, filel. 

$REWIND,FILE1. 
/copysbf, filel, file2. 

END OF INFORMATION ENCOUNTERED, 
/rewind, file2. 

$REWIND,FILE2. 
/copy,file2. 
UaBbCcDdEeFfGg 

HhliJjKkLlMmNn 

EOI ENCOUNTERED, 
/rewind, file2. 

$REWIND,FILE2. 

/fcopy,p=file2,n=file3,r. 
FCOPY COMPLETE. 

/route, file3,dc=lp,ec=a9. 
ROUTE COMPLETE. 

The following is the line printer output from the ROUTE statement. 

AaBbCcDdEeFfGg 
HhliJjKkLlMmNn 

LIST80 STATEMENT 

The LIST80 routine reads a file containing list output produced by the COMPASS assembler 
and compresses it to 80 columns, which fits on 8-1/2-by 11- inch printer paper. 

The control statement format is: 

LISTSOdfn^lfng.NR) 

Lfaj File to copy from; if this parameter is omitted, file LIST is assumed. 

lfn 2 File to copy to; if this parameter is omitted, file OUTPUT is assumed. 

NR If this parameter is specified, lfn. is not rewound. 

LOCK STATEMENT 

The LOCK control statement enables the user to prevent writing on a file. 

The control statement format is: 

LOCKdftij, lfng, . . . , lfn n ) 

lfn. Logical file name of a local file. 

With the LOCK statement, the user can set the write interlock bit in the FNT/FST entry for 
a local file. Subsequently, the system allows only read operations on the file. The file 
specified must be a local file; if it is not, the following message is issued. 

ILLEGAL FILE TYPE. 
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The LOCK statement may also be used in conjunction with the COMMON statement to 
lock local files before making them library files for multiple user access. Refer to 
Library Files in section 2 and the COMMON control statement in this section. 



L072 STATEMENT 

The L072 control statement allows the user to specify the reformatting of his files. 
The control statement format is: 



L072(p 1 ,p 2 , 
Pi 



.P n ) 



Any of the following parameters in any order: 



I 

I=lfn, 
1=0 1 



S 
S=lfn„ 



L=lfn„ 



T 
T=x 



H 
H=xxx 



Reformat parameters are on file INPUT. 
Reformat parameters are on file Ifn-. 
There is no input file of reformat parameters. 
If the I parameter is omitted, 1=0 is assumed. 

Data to be reformatted is on file SCR. 

Data to be reformatted is on file lfn„. If the 

S parameter is omitted, SCR is assumed. 

Reformatted data is listed on file OUTPUT. 



Reformatted data is listed on file lfn„ 



If the 



L parameter is omitted, OUTPUT is assumed. 

File to be reformatted is of type B. 

File to be reformatted is of type x, where x is: 

M Modify source data 

C COMPASS source data 

B Other source data 

If the T parameter is omitted, B is assumed. 

Number of characters per output line is 72. 
Number of characters per output line is xxx 
(maximum allowed is 150 characters). If the 
H parameter is omitted, 72 is assumed. 



NOTE 



H must be greater than or equal to the 
number of characters being moved (Nx) 
plus the starting column number of the 
destination field (Ox). 
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LP 
NR 

Nx=y 



Output is formatted for the line printer. 

Output file is not rewound. 

Specifies the number of characters to be moved 
(up to 6 fields): 

x(l to 6) Number of the field being moved 

y Number of characters being moved 



1 NOTE | 

The follwing restrictions apply 
to the H, N, Land O param- 
eters: 



(Nx+bc). GT. 150 

(Nx+Ox).GT.H 

H.GT.150 



Yields an error 
Yields an error 
Yields an error 
wTner e j. ^ x^ v 



Ix=y 



Ox=y 



IT 



Specifies the field the data originates from: 
x(l to 6) Number of the field being moved 
y Starting column of originating field 

Specifies the destination field the data is going to: 
x<l to 6) Number of the field to receive data 
y Starting column of destination field 

Suppresses query to terminal asking if user wishes 
to change any of the input parameters before 
processing begins. If omitted, query is issued. 
This parameter is effective only from time- sharing 
origin jobs. 

The following shows the default values assumed for the N, O, and I parameters for the 
various source types. 

Type 
B 
C 

M 

The remaining parameters of these types are defaulted to 0. 

L072 reformats files (output files in general). The user can rearrange each line (all 
lines must be formatted the same) in the format he chooses. All default values com- 
press output to 72 columns, which is appropriate for terminal output or 8-1/2 by 11-inch 
printer paper. If a 1 is encountered in column 1 (the page eject printer control charac- 
ter), the next two lines of source data are processed as a two-line header. This 
header is compressed to 72 columns for all source types. If no page eject control 
characters are encountered, no headers are processed. 



Nl 


11 


Ol 


N2 


12 


02 


N3 


13 


03 


72 


1 


1 




















7 


9 


1 


50 


41 


8 


15 


112 


58 


2 


6 


1 


48 


10 


3 


22 


82 


51 
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The following values apply to the first line of header and cannot be changed. 

Nl=42, 11=8, Ol=0 (if LP not specified; otherwise, 01=1) 
N2=20, 12=90, 02=42 
N3=5, 13=115, 03=62 
N4=5, 14=121, 04=67 

The subheader lines for COMPASS and Modify listings are processed uniquely. 

For B listings, the following values apply to the reformatting. 

Nl=43, 11=8, Ol=0 (if LP not specified; otherwise, 01*1) 
N2=29, 12=70, 02=43 

All parameters are passed to L072 by the control statement. If an input file is speci- 
fied, L072 reads it for additional input parameters. If the job originates from a time- 
sharing terminal, and the IT parameter is not specified, the user is asked if he wishes 
to change any of the input parameters. If he enters YES, the system prints the current 
parameter, values and allows him to change them individually. Pressing the carriage 
return key for any parameter leaves the parameter at its former value. In the follow- 
ing examples, the same input parameters are entered in three possible ways. 

Control Statement : 

LO72(I=0, S=SOURCE, T=B, L=OUT, N4=l, 14=2, 04=75, H=90) 

Time- Sharing Terminal : (User entries are in lowercase. The symbol © indicates 
carriage return. ) 

/lo72 

DO YOU WANT TO CHANGE ANY CONTROL ARGUMENT VALUES- 

ENTER: YES OR NO 

? yes © 

ARGUMENT VALUE 

INPUT FILE NAME j ? © 

SOURCE FILE NAME? SCR ? source © 

OUTPUT FILE NAME: OUTPUT ? out© 

SOURCE FILE TYPE: BATCH ? b © 

OUTPUT LINE LENGTH: 72 CHARS.? 90 © 

NO. OF MOVED FROM MOVED TO 

CHARS. COLUMN COLUMN 
(X) (NX) (IX) (OX) 
' 1. 72 1 1 

2. 

3. 

4. H 

5. 

6. S « $ 

ENTER CHANGES IN THE FOLLOWING FORMAT: 
NX«AA*CR* 
IX*BB*CR* 
0X»CC*CR* 
ETC. 

TO CONTINUE, ENTER *CR* ONLY.- ? n4«l © 
? 14=2 © 
7 o4»75 © 
?© ** 
L072 COMPLETE. 
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Input File: {Each line in the input file must end with a terminator. ) 



I 



S=SOURCE, L=OUT, T=S. 
N4 = l, 14=2, 04=75. 
H=90. 
-EOR- 



NEW STATEMENT 

The NEW control statement creates a primary file. 
The control statement format is: 
NEW(lfn/ND) 

tf Q Name of file to be made primary file. 

ND If this parameter is specified, other files currently assigned 

to the job are not released. 

The NEW statement creates an empty file and makes it the user's new primary file Anv 
currently existing primary file is released. ' 

All files assigned to the job are released unless the ND parameter is specified. 
Refer to the note in PRIMARY Statement in this section for use of primary file types. 

OUT STATEMENT 

The OUT control statement releases output files from the control point to the output 
queue. ^ 

The control statement format is: 

OUT. 

The only files released are those having the names 

OUTPUT 
PUNCH 
PUNCHB 
P8 

or any local files belonging to one of these types. An example would be any of the 
above files that had been renamed. 

The number of files released is recorded in the job's dayfile with the message 

xx FILE(S) RELEASED, 
where xx is the octal number of files released. 
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If no files with the above names or belonging to these types are found, the following message 
is issued to the dayfile: 

NO FILE(S) RELEASED. 

This control statement is used if the user wishes to initiate printing or punching of the files 
before job termination. The PUNCH file is punched in either 026 or 029 mode, depending 
on the origin of the job. If the job is a local batch job, the coded deck is punched in the 
initial keypunch mode of the job's control statement record. For all other job origin types, 
the coded file is punched in the system default keypunch mode. 

PACK STATEMENT 



The PACK control statement removes all EOR and EOF marks from a specified file and g 

copies it as one record to another file. I 

The control statement format is: 

PACKOfnplfng.x) 

lfn. Name of file to be packed. 

lfn 2 Name of file to receive packed data. 

x If a third parameter (1 to 7 alphanumeric characters) is 

specified, lfn- is not rewound before the pack occurs. 

The input file, lfnj, may consist of any number of records and /or files. If no third 
parameter is supplied, lfnj is read from the BOI to the EOI, and all EOR and EOF 
marks are removed. It is written to file lfn 2 at the current position as one record. 
File lfn2 is rewound after the pack; lfn. is not. If lfn„ is not specified, file lfn 1 is 
packed to itself. 



PRIMARY STATEMENT 

The PRIMARY control statement makes a local file the primary file, or it creates an 
empty primary file. 

The control statement format is: 

PRIMARY(lfn) 

lfn Name of local file. 

If- lfn already exists, it must be a local mass storage file in order to be made the 
primary file. If lfn does not exist, the PRIMARY statement creates it on mass 
storage. Any currently existing primary file (other than the lfn specified) is released. 
If the specified file is already primary, the operation is ignored. 
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1 NOTE 

The primary file is rewound before every opera- 
tion performed on that file. Therefore, the file 
manipulation statements BKSP, SKIPEI, SKIPF, 
SKIPFB, and SKIPR cannot be used to position 
within the file. The user should also remember 
that the primary file is rewound after the comple- 
tion of any of the COPY statements. An attempt 
to add to the file using one of the COPY statements 
may result in writing over existing data at the BOI. 

RENAME STATEMENT 

The RENAME control statement allows the user to change the name of a local file. 
The control statement format is: 

RENAME (nlfn 1 =olfn 1 , nlfn 2 =olfn 2 nlfn n =olfn n ) 

nlfn i New name of the local file. 

olfn. Existing name of the local file. 

The RENAME control statement changes the name of the file olftis to nlfnj in the FNT/FST. 
This does not change the names of files in the permanent file system. Normally, the file 
type of nlfn is the same as the file type of olfn. 

If a file by the name nlfn. already exists, it is returned to the system. Under certain 
conditions, the system also changes the file type of olfn. to that of the file which was 
returned. x 

• If olfn. is a local mass storage file and the returned file was a print, punch, 
or primary type file, olfn. is renamed and its file type is changed to that of 
the returned file. 

• If olft^ is a local mass storage file and the returned file was not a print, 
punch, or a primary type file, olfn. is renamed but its file type is not changed. 

• If olfnj is not a local file and nlfn and olfn are not the same file types or if 
olfn. does not reside on mass storage, an 

ILLEGAL FILE TYPE. 

error message is issued. 

For example, the user has only two files assigned to his job. File A is a local mass 
storage file, and file B is a print type file. If the user issues the following request 

RENAME (X=A) 

file A is renamed file X, and its file type (local) is not changed. However, if the user 
issues the request 

RENAME(B=A) 

file B is returned to the system; file A is renamed file B and changed to print type file. 
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REQUEST STATEMENT 

The REQUEST statement sends a message to the system operator requesting that the named 
file be assigned to the device described in the comment field. 

The control statement format is: 

REQUEST (lfn, j^g}) comment | 

lfn Name of the file to be assigned to the specified equipment. 

CK Specifies that lfn is to be used as a checkpoint file. Each time 

a checkpoint dump is taken, the new information is written at the 
previous EOI of lfn. 

CB Specifies that lfn is to be used as a checkpoint file. Each time 

a checkpoint dump is taken, the new information is written at the 
BOI of lfn. 

If lfn already exists when the REQUEST is made, no new assignment is made and job 
processing continues with the next control statement. However, the user can reassign 
lfn by issuing a RETURN on the file before making the REQUEST. 

Any user, regardless of his validation, may use the REQUEST statement to assign a 
file to a mass storage device. However, to assign a file to a nonmass storage device, 
the user must be validated to use nonallocatable devices. f If the user does not have 
this validation and attempts to request a nonmass storage device, the system aborts 
his job. 

If lfn is to be used for checkpoint dumps, either the CK or CB keyword is specified. 
These keywords are used in conjunction with the CKP and RESTART control statements; 
they allow the user to: 

• Save all checkpoint dumps by appending each dump to the checkpoint file: 

REQUEST (lfn, CK) 

• Save the last checkpoint dump by writing each dump at the beginning of the 
checkpoint file: 

REQUEST(lfn, CB) 

• Save two consecutive checkpoint dumps by alternately writing on two checkpoint 
files : 

REQUESTOR, CB) 
REQUEST(lfn 2 , CB) 

If the CK parameter is specified for alternate files or if more than two checkpoint files 
are specified, the job is aborted and the following message is issued to the user's 
dayfile. 

CHECKPOINT FILE ERROR. 



t Refer to LIMITS control statement in section 6. 
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The CK and CB parameters specify a checkpoint file that is local to the job The user 
REQUEST * e checkpoint file P erm a n ent by placing a DEFINE statement before the 

DEFINE(lfn) 
REQUESTdfn, CK) 
CKP. 

The user is not required to supply a REQUEST statement to define a checkpoint file He 
can use an ASSIGN or LABEL statement or he can use default values. 

If no REQUEST statement specifying a checkpoint file has been detected when the first 
CKP statement is encountered, the system requests a device for the user, specifies a 
file name of CCCCCCC, and selects the CK option. For a subsequent restart job 
however, the system assumes the user has made the checkpoint file available. 

The REQUEST statement can also be used to create or access existing 7- or 9- track 
unlabeled tapes. If a magnetic tape assignment is needed to satisfy a REQUEST th<» 
JWT or NT parameter should be specified. For a description of magnetic tape assign- 
ment with the REQUEST statement, refer to Tape Management in section 10. 

RESEQ STATEMENT 

The RESEQ control statement is used to resequence source files which have leading 
sequence numbers or to add sequence numbers to an unsequenced file. 

The control statement format is: 
RESEQ(lf n. t, xxx, yy) 

Ifn Name of the sorted file to be resequenced. RESEQ does not sort Ifn 

(refer to the SORT statement). 



Type of file: 



BASIC source code. 



T Text source information; a five-digit sequence number 

plus a blank is added at the beginning of each line; the 
file text, however, is not inspected. 

other Any number at the beginning of a line is considered a 

or sequence number and is resequenced according to the 

omitted xxx and yy parameters, numbers are added to lines 

where no leading sequence numbers are present. This 
option can be used with time- sharing FORTRAN 
statements. 

xxx New line number of the first statement; if this parameter is omitted, 

the system assumes xxx=100. 

yy Increment to be added to xxx for each succeeding line number; if this 

parameter is omitted, the system assumes yy=10. 



T Any mass storage file used as a checkpoint file must have write permission. 
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Files which have leading sequence numbers include time-sharing FORTRAN and BASIC 
source files. If the file has no leading sequence numbers, five-digit numbers are inserted 
at the beginning of each line. If the line number encountered or required exceeds 99999, 
RESEQ issues an error message. 

When resequencing a BASIC source program, the user must specify B for the file type 
parameter, t, so that RESEQ changes the line number references within the source state- 
ments. RESEQ supplies five-digit line numbers and line number references; excess 
surrounding blanks are used in the expansion of line number references. 

Example : 

File X contains the following BASIC source statements. 

95 ON SGN(A)+2 GOTO 100,110,120 'COMMENT 

100 PRINT "A IS NEGATIVE" 

105 GOTO 130 'COMMENT 

110 PRINT "A IS ZERO" 

115 GOTO 130 'COMMENT 

120 PRINT "A IS POSITIVE" 
130 LET B=A+1 
135 END 
The following statement changes the contents of file X. 

RESEQ(X, B, 90, 10) 

The user then rewinds and lists file X. 

00090 ON SGN(A)+2 GOTO 00100,00120,00140 'COMMENT 

00100 PRINT "A IS NEGATIVE" 

00110 GOTO 00150 'COMMENT 

00120 PRINT "A IS ZERO" 

00130 GOTO 00150 'COMMENT 

00140 PRINT "A IS POSITIVE" 

00150 LET B=A+1 

00160 END 

The RESEQ statement changes the line numbers and the line number references. Line 
numbers now begin at 90 and increment by 10. The comment on the first line is moved to 
the right to allow for the expanded line number references. 



60435400 J 1-7-31 



RETURN STATEMENT 

The RETURN control statement releases files assigned to a job and may release file space 
depending on the file type. H 

The control statement formats are: 

RETURNdfnj, lfn 2 , . . . , lfn n ) 

or 

RETURN(*,lfn 1 ,lfn„,...,lfn ) 
i & n 

The first format returns the named files (lfiij, If no lfnj. The second format returns all 

files assigned to the job except the named files. If no files are named on the second format 
the asterisk specification returns all files assigned to the job. An error message is returned 
if neither an asterisk. nor a file name is specified. 

x\xli uniN penorms tne louowing operations according to the file type. 

T yP e Operation 

In P ut The file name is changed to INPUT*. File space is not released (refer 

to Input File Control in section 3 for further information). 

Print File s P a c e is released, and the file is no longer assigned to the iob. 

(The file is not printed. ) 

Punch File space is released, and the file is no longer assigned to the iob. 

(The file is not punched. ) 

Local File s P a ce is released, and the file is no longer assigned to the job. 

Primary Same as Local. 

System File space remains, but the file is no longer assigned to the job. 

Library File space remains, but the file is no longer assigned to the job. 

Direct access The write interlock is cleared. File space remains, but the file is 
no longer attached to the job. 

In addition, the RETURN of a magnetic tape file or the RETURN of the user's last direct 
access file on an auxiliary removable disk pack decrements the resource demand count as 
scheduled by the RESOURC control statement if, and only if, the total concurrent resource 
demand (tapes and removable packs) has been satisfied. 

To release a file without decrementing the resource demand count, the user can issue an 
UNLOAD statement. To release file space without releasing the file from the iob. the user 
can issue an EVICT statement. J 
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REWIND STATEMENT 

The REWIND control statement rewinds files. A mass storage file is positioned at its BOI. 
An unlabeled tape file is positioned at its load point. A labeled tape file is positioned after 
the first HDR1 label for the file. If the tape file begins on a previous volume, the system 
notifies the operator to mount that volume. 

The control statement formats are: 

REWINDClfnj, Ifrig, .... lfn n ) 

or 

REWINDS. lfn r lfn 2 , .... lfn R ) 

The first format rewinds the named files (lfnj, lfn 2 . . . . ,lfn n ). The second format rewinds 
all files assigned to the job except the named files. If no files are named on the second 
format, the asterisk specification rewinds all files assigned to the job. 

If the previous operation on the magnetic tape file was a write, a REWIND statement causes 
the following operations to be performed. 

1. If the tape is ANSI labeled, the system writes a tape mark, an EOF1 label, and 
three tape marks and then rewinds the tape. 

2. If the tape is unlabeled and the data format specified on the ASSIGN, LABEL, or 
REQUEST statement is S, L, or F, the system writes four tape marks and then 
rewinds the tape. 

3. If the tape is unlabeled and the data format is I or SI, the system writes a tape 
mark, an EOF1 label, and three tape marks and then rewinds the tape. 

Refer to Magnetic Tape Files in section 2 and to Tape Management in section 10 for further I 
information about tape files and to appendix G for a description of EOF1 and EOV1 labels. 



ROUTE STATEMENT 

The ROUTE control statement prepares a designated file for release to an input or output 
queue. The file routing requested may take effect when the statement is processed, or it 
may be deferred. If deferred, the routing characteristics specified define the handling of 
the file in later job steps or at job termination. This statement also allows the user to 
rescind a prior deferred ROUTE statement, changing the file type to local. 

The control statement format is: 

ROUTEdfn, Pj, p 2 , . . . , p n ) 

Descriptions of the statement parameters follow. The Ifn parameter is required on all 
ROUTE statements. 

Ifn Name of the file to route. Ifn can be an input, print, punch, or local 

file; it cannot be a primary or direct access file. 
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The remaining parameters are order-independent. 

Pj Description 

DC=xx Disposition code; assumes any one of the following 2-character 

codes . 

IN Release file to input queue. Normal job input file format 

is required. If the job statement within the file is in error, 
the file is not released and remains a local file. ROUTE 
issues a dayfile message explaining the error. 



Print codes: 




LP 


Print on any printer 


PR 


Same as LP 


LR 


Print on 580-12 printer 


LS 


Print on 580-16 printer 


LT 


Print on 580-20 printer 


Punch codes: 




SB 


Punch system binary 


PB 


Same as SB 


P8 


Punch 80-column binary 


PU 


Punch coded 


PH 


Same as PU 


PL Plotter 


SC Rescind prior routing and change the file type to local 



If the DC parameter is omitted and lfn is a deferred routed file 
(refer to the FM parameter), the disposition code previously 
specified remains in effect. If the DC parameter is omitted and 
lfn is not a deferred routed file, the default depends on the file 
name specified for lfn. 

If DC is omitted and lfn is: ROUTE assumes DC is: 

OUTPUT DC=LP 

PUNCH DC=PU 

PUNCHB DC=SB 

P8 DC=P8 

Any other name DC=SC 



1-7-34 60435400 J 



p. Description 

DEF Indicates that routing of the file to the queue is deferred to a later 

job step or end of job. If this parameter is specified, the file is 
created if it does not exist. DEF is not allowed if DC=IN. 

EC=xx Defines external characteristics for print or punch files. 

For print files, xx can be the following. 

A4 Provided for NOS/BE compatibility. 

A6 ASCII 64-character set. 

A 9 ASCII 95-character set. 

B4 Provided for NOS/BE compatibility. 

B6 Display code 63 /64-character set. 

For punch files, xx can be the following. 

ASCII Punch ASCII. 

02 6 Punch 026 mode. 

02 9 Punch 02 9 mode. 

SB Punch system binary. 

80COL Punch 80- column binary. 



FnotTI 

If an invalid external characteristic is speci- 
fied, the queue file processor cannot output 
the file. The user must not specify a print 
file characteristic for a punch file or a punch 
file characteristic for a print file. He also 
must not specify an external characteristic 
not available at the site. If EC is not speci- 
fied, an appropriate EC default is set on the 
basis of the DC parameter setting and in- 
stallation options. 



FC=xx Forms code; specifies routing to the output device that the system 

operator assigned the forms code xx. This parameter prevents 
output of a file before its special forms are placed in the output 
device, xx can be any 2 alphanumeric characters, but the com- 
binations null, AA, AB, AC, AD, AD, AE, and AF give maximum 
system efficiency. A value of null results when no FC parameter 
is specified. 

FID=xx An NOS/BE parameter included for compatibility. It produces an 

informative message under NOS. 

FM Implicit remote routing (refer to the following note). 
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_Pj . Description 

FM = xx 1 to 7 alphanumeric character family name; indicates routing to a 

remote batch terminal logged in with the specified family name. 
The note following the ROUTE parameter descriptions describes 
the default procedures. 

IC=xx Internal characteristics; specifies one of the following. 

DIS Display code 

ASCII ASCII code 

BIN Binary 

This parameter is normally not specified since its default is 
automatically established through the disposition code DC. 

ID=xx Selects local device ID from to 67 (octal default). This is 

identical to the ID specified by the SETID control statement. 

ID Implicit central site routing (refer to the note at the end of the 

parameter descriptions). 

PRI=xx File priority. This is a NOS/BE parameter included for com- 

patibility. It produces an informative message under NOS. 

REP=xx The number of additional file copies to be routed to a destination. 

The range for xx is from to 31; therefore, the number of 
copies that can be sent ranges from 1 to 32. Values for xx beyond 
its range are set to zero, an informative message is set, and 
one copy is routed to the destination. 

SC=xx Spacing code for the 580-PFC printer. This is a numeric value 

from to 77 (octal default). 

ST=xx Station ID. This is a NOS/BE parameter included for compati- 

bility. It produces an informative message under NOS. 

T 113 Implicit remote routing (refer to the note at the end of the 

parameter descriptions). 

TID=C Central site routing. This is a NOS/BE parameter included for 

compatibility. Its action is identical to the ID parameter. 

TID=xx Terminal ID. This form of the TID parameter is included for 

NOS/BE compatibility. Under NOS, it is processed the same 
as TID; however, an informative message is issued stating that 
xx is ignored. 

UN Implicit remote routing (refer to the note at the end of the 

parameter descriptions). 

UN 3 ** Specifies the user number of the remote batch user to whom the 

named file is routed. The parameter xx is valid only if it 
matches the user number of the user performing the route. 
The matching is character for character except for those posi- 
tions containing an * (refer to the note at the end of the param- 
eter descriptions). 
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I NOTE 1 

For remote batch origin (EIOT) jobs, the following action is 
taken. 

• Parameter ID, ID=xx, or TID=C causes routing to the 
central site. 

• Parameter FM, TID, or UN with no argument causes 
routing to the terminal of origin. 

• The omission of FM, TID, or UN causes routing to 
the terminal of origin. 

• Parameter FM or UN with legal arguments causes 
routing to the specified terminal. 

For jobs of any origin other than EIOT, the following action is 
taken. 

• Parameters ID, ID=xx, and TID=C causes routing to 
the central site. 

• Specifying UN, TID, or FM without parameters causes 
routing to the terminal specified by the job's FM and 
UN at the time of the ROUTE call. 

• Specifying UN or FM with legal arguments causes 
routing to the selected remote terminal. 

If a job is routed to the input queue with an illegal USER control statement, the following 
message is issued 

DSP - ILLEGAL USER CARD. 
SYSTEM ABORT. 

and the job is aborted with no error exit processing or if submitted from a terminal, the 
terminal is logged off. The security count for the user number that did the ROUTE is de- 
cremented accordingly. 

SETID STATEMENT* 

The SETID control statement assigns a new identification code for the specified file. 
The control statement format is : 

SETID{lfni=x lt lfn 2 =x 2 , . . . , lfn n =x n ) 

lfn^ Logical file name. 

Xj New identification code for the file (0 through 67 8 ). This code must 

match the device identification code specified in the EST. (The 
installation establishes the device identification codes.) 

The identification code allows the user to route his file to an output device or device group 
with the same identification code. This is useful when a print file requires special forms. 

The file LFN* must be an input (INFT), local (LOFT), print (PRFT), or punch (PHFT) type 
file, or the following message is issued. 

ILLEGAL FILE TYPE 



t The ROUTE control statement should be used to perform this operation. 



60435400 J 1-7-37 | 



SKIPEI STATEMENT 

The SKIPEI control statement directs the system to position the specified file at the EOI. 

The control statement format is: 

SKIPEI(lfn) 

lfn Name of the file to be positioned. 

On magnetic tapes where no EOI is defined, the operation stops at an EOF. 

The SKIPEI statement has no effect on a primary file since the file is rewound before 
every operation. 



SKIPF STATEMENT 

The SKIPF control statement directs the system to bypass, in a forward direction, the 
specified number of files from the current position of "the named file. 

The control statement format is: 

SKIPF(lfn,n,m) 

lfn Name of the file to be positioned. 

n Number (decimal) of files to be skipped; if the parameter is 

omitted, the system assumes n=l. 

m File mode: C for coded, B for binary. If omitted, the system 

assumes the file is in binary mode. If coded mode is set on 
an SI tape, the system aborts the job. 

If an EOI is encountered before n files are bypassed, file lfn remains positioned at 
the EOI. 

The SKIPF statement has no effect on a primary file since the file is rewound before 
every operation. 



SKIPFB STATEMENT 

The SKIPFB control statement directs the system to bypass, in the reverse direction, 
the specified number of files from the current position of the named file. 

The control statement format is: 

SKIPFBafn,n,m) 

lfn Name of the file to be positioned. 

n Number (decimal) of files to be skipped; if the parameter is 

omitted, the system assumes n=l. 

m File mode: C for coded, B for binary. If omitted, the system 

assumes the file is in binary mode. If coded mode is set on 
an SI tape, the system aborts the job. 
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The system does not backspace past the beginning-of-information (BOD or load point 
(tape file) in the event that BOI or load point is encountered before n files are bypassed. 

The SKIPFB statement has no effect on a primary file since the file is rewound before 
every operation. 



SKIPR STATEMENT 

The SKIPR control statement directs the system to bypass, in a forward direction, the 
specified number of logical records from the current position of the named file. 

The control statement format is: 

SKIPROfn, n.l.m) 

lfn Name of the file to be positioned. 

n Number (decimal) of records to be skipped; if this parameter 

is omitted, the system assumes n=l. 

[ EOR level; 0gt£l7. If 0^f£l6, the system assumes i =0. 

If I =17, n indicates the number of files to skip rather than 
records . 

m File mode: C for coded, B for binary. If omitted, the system 

assumes the file is in binary mode. If coded mode is set on 
an SI tape, the system aborts the job. 

EOR marks are considered separate records and included in the record count. If the 
EOI is encountered before n records are bypassed, file lfn remains positioned at the 
EOI. 

The SKIPR statement has no effect on a primary file since the file is rewound before 
every operation. 



SORT STATEMENT 

The SORT control statement enables the user to sort a file of line images or statements 
in numerical order based on leading line numbers consisting of a specified number of 
digits. 

The control statement format is: 

SORT(lfn,NC=n) 

lfn Logical file name of the file to be sorted; lfn may be a local 

file or a direct access permanent file. 

n Number of leading line number digits on which the file is to 

be sorted; n < 10. If the NC parameter is omitted, the 
system assumes n=5. 

In the case of duplicate line numbers, all lines other than the first are considered 
correction lines. All lines with the same number are deleted from the file except the 
last line encountered. 
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For input from a time- sharing terminal,. SORT deletes a line image or statement if a line 
number is followed by an empty line or a line number is followed by a blank and a carriage 
return. 

For batch input, SORT deletes a statement or line image if a card containing only the line 
number is submitted. 

If a line number contains more than n digits, the user can delete the line either by entering 
the first n digits of the line number and pressing the carriage return (terminal input) or b'y 
submitting a card containing only the first n digits of the line number (batch input). 

After the sort, lfn is packed and set at EOI. 



TCOPY STATEMENT 

The TCOPY control statement copies X (external) format binary tapes or E (line imaee) 
oj x^i^v.n.v.v*;, uj oi vojfovcui imeiutti/ lui'tuai couea tapes to mass storage, to an l format 
tape, or to an SI binary format tape. It also writes E or B format tapes converted from files 
on mass storage, I format tape, or SI format binary tape. The X binary and E, B, and SI 
coded tape formats were supported under earlier versions of NOS. Now, to access data or 
write data in one of these formats, the tape must be assigned as an S (stranger) format tape 
(refer to the tape assignment statements in section 10) and the file copied using the TCOPY 
statement. 5 

The parameters on the TCOPY control statement can appear in order-dependent format, 
order- independent format, or a combination of both. The completely order-dependent 
format is: 

I TCOPY(lfn lf lfn 2 , format, tc, copycnt, charcnt, erlimit. P^P,. lfn-) 

The completely order- independent format is: 

| TCOPYU^lfn^ 0=lfn 2 , F=format, TC=tc, N=copycnt, CC=charcnt. EL=erlimit, PO=p 1 p 2 , 

If order-dependent and order- independent parameters are mixed in one TCOPY statement, 
the order-dependent parameters must appear in their proper position. All parameters are 
optional. However, the specification of certain parameters precludes the application of 
others. A nonapplicable parameter may be ignored or it may be illegal. This is stated in 
the individual descriptions of the parameters. 

The parameters are defined as follows: 

Parameter Description Default 

I=lfn 1 Name of the file to copy from. INPUT 

0=lfn 2 Name of the file to copy to. OUTPUT 

F=format Data format that specifies the type of X 

conversion for the copy operation. This 
can be any one of the following. 
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Parameter 



format 



Description 

Conversion 



Default 



TC=tc 



E Copy an E format tape to mass 

storage, an I, or an SI binary- 
tape file, or generate a new E 
format tape from mass storage, 
an I, or an SI binary tape file. 
The E tape must be unlabeled 
and assigned as S format. 

B Copy a B format tape to mass 

storage, an I, or an SI binary 
tape file, or generate a new B 
tape from mass storage, an I, 
or an SI binary tape file. The 
B tape must be unlabeled and 
assigned as S format. 

X Copy an X format tape to mass 

storage, an I, or an SI binary 
tape file. The unlabeled input 
tape must be assigned an S 
format, with noise size of 8 
for 7 -track or 6 for 9- track 
tape (refer to NS parameter 
on tape assignment control 
statement). 

SI Copy an SI coded format tape 

to mass storage, an I, or an 
SI binary tape file. The 
labeled or unlabeled input tape 
must be assigned as S format, 
with noise size of 8 for 7-track 
or 6 for 9-track tape (refer to 
NS parameter on tape assign- 
ment control statement). SI 
coded input tape is completed 
before EOI is encountered, the 
position of the input tape after 
the copy is indeterminate. 
This is because control words 
are used on the SI coded tape 
read via S format (EOF on an 
SI coded tape is a level 17g 
block terminator, whereas 
EOF on an S tape is a tape 
mark). 

Specifies the copy termination condition used 
in conjunction with N=copycnt. The termi- 
nation condition can be specified as follows: 

F or When this TC value is set, the 

EOF N keyword specifies the number 

of files to copy. 



Copy to double EOF 
(TC=D or TC=EOD) 
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Parameter 



N=copycnt 
CC=charcnt 



EL=erlimit 



| PO= PlP 2 



Description 

I or This specifies a copy to the end 

EOI of information. The N keyword 

is ignored. 

D or When this TC value is set, the 

EOD N keyword is the number of 

double EOFs to copy to. 

Copy count used by the copy termination 
condition TC. 

The character count which determines max- 
imum block size (line length) in characters 
for an E or B format tape. This parameter 
can only be specified on an E or B format 
tape copy. 

Error limit which sets the number of non- 
fatal errors allowed before abort. This 
includes parity errors and block- too- large 
errors which are returned by the tape sub- 
system after completing recovery proce- 
dures. It also includes illegal block for- 
mat errors (invalid byte-count and/or 
unused bit count) for X format and SI 
coded format tapes. Error limit is ig- 
nored when generating an E or B format 
tape from mass storage, an I format, 
and an SI binary format file since control 
word read is not used. Error limit is 
likewise ignored if the input file device 
does not support control word read 
(terminals). In that case, any error 
aborts the job. 

One or both of the following processing op- 
tions (not separated by commas). 



Default 



136 characters for E 
format; 150 characters 
for B format. 



Zero 



L=lfn„ 



E Input blocks with parity errors 

or block- too- large errors are 
processed (copied). 

T When generating a B or E 

format tape, blocks exceeding 
the maximum block size (refer 
to the CC parameter) are 
truncated. POT is illegal for 
other file conversions. 

Name of an alternate output file to receive 
parity error messages when extended error 
processing is in effect (nonzero EL speci- 
fied), in which case, the file name lfn~ 
must not be the same as lfn . 



Error blocks are 
skipped. 

Lines exceeding the 
maximum line size are 
split into multiple 
blocks. 



OUTPUT 
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Example: 

The following TCOPY statement combines order-dependent and order- independent 
parameters: 

TCOPY(TAPE1,FILE2,E,CC=200,EL=12) 

The input file TAPE1 is an E format tape (assigned as an S format tape). It has a 
maximum of 200 characters per line. The copy terminates when a double EOF is en- 
countered (default). The output file FILE2 can be a mass storage file or an I or SI 
binary format tape. The error limit allows up to 12 nonfatal errors (parity/block-too- 
large), and the bad data is skipped (default) with informative error messages written 
to the file OUTPUT (default). 

The TCOPY statement begins a copy operation at the current position of both files and 
continues until the copy termination condition is met or EOI is encountered. This termina- 
tion condition can be a file count, double EOF count, or EOI. If the copy is terminated by 
a double EOF (for TC=EOD option), the second EOF is detected on lfni but is not transferred 
to lfn2. If lfn^lfng, the named file is read until the termination condition is satisfied or 
EOI is encountered. An SI coded tape can be positioned correctly only to EOI (refer to the 
F=SI parameter description). 

If a copy specifies a file count TC=EOF, and EOI is encountered on the input file before the 
file count is satisfied, an additional EOF is written on the output file only if data or records 
have been transferred since the previous EOF was written (or since the beginning of the 
copy, if no EOFs have been encountered). 

The EL or PO=E options provide extended error processing. This allows the processing 
or skipping of blocks with parity errors or block- too- large errors. If EL is set to a 
value greater than zero, a parity error or block-too-large error on the input tape 
generates the following message on the alternate output file. 

PARITY/ BLOCK TOO LARGE ERROR IN BLOCK n. 

n is the decimal block count of the block in error. The block count for the first block to be 
copied is initially set to zero and is incremented by 1 for every block and every EOF 
processed. For X and SI coded formats, an illegal block format error (illegal byte count 
and/or unused bit count) produces the following message on the alternate output file. 

ILLEGAL FORMAT IN BLOCK n. 

When creating a B format tape from a mass storage, I, or SI binary format file, a block 
shorter than the noise size specified on the tape assignment statement is blank filled to the 
noise size. A noise block could also be generated when a block exceeding the maximum 
block size for the B format tape is split into multiple blocks. If the PO=T parameter is 
specified, blocks exceeding the maximum block size are truncated. 

When creating an E format tape from a mass storage, I, or SI binary format file, blocks 
that exceed the maximum block size for the E format tape are split into multiple blocks. If 
a continuation block contains only the end-of-line indicator (zero word), the continuation 
block is discarded. If the PO=T parameter is specified, blocks exceeding the maximum block 
size are truncated (all continuation blocks are discarded). 
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TDUMP STATEMENT 

The TDUMP control statement lists a file in octal and/or alphanumeric format. It dumps 
the entire Me or the specified number of lines, records, or files. If more than one limit 
is set, the limit reached first overrides the others. 

| NOTE | 

TDUMP produces unpredictable results when 
dumping an S, L, or F format tape file. The 
user should use the COPY statement to convert 
the S, L, or F format tape file to a mass 
storage file or to an I or SI binary format tape 
file before attempting to dump the file using 
TDUMP. 



The control statement format is: 

TDUMP( Pl ,p 2 p n ) 

p^ - Any of the following in any order: 

l=Un 1 1 to 7 alphanumeric characters naming the local file to be 

dumped (default is TAPED. 

L=lfn 2 1 to 7 alphanumeric characters naming the local file to which 
the output is written (default is OUTPUT). If lfn 2 is not a 
local file, TDUMP creates it. It does not rewind lfn„ 
following the dump. 2 

O Octal dump only. 

A Alphanumeric dump only. 

If both O and A are specified, the last one overrides. If 
neither O nor A is specified, TDUMP lists both an octal and 
an alphanumeric dump. 

R=rcount Maximum decimal number of records to be dumped. If R is 
omitted or set to zero, the dump continues to EOI. 



NOTE 



The record count restarts at each EOF. 



F-fcount Maximum decimal number of files to be dumped. If F is 

omitted, the dump continues to EOI. If F=0, dump continues 
until an empty file (double EOF) or EOI is encountered. 
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N=lines Maximum decimal number of lines to be dumped. If N is 

omitted or set to zero, the dump continues to EOI. The blank 
line output with the end of record, end of file, end of informa- 
tion, and ABOVE LINE REPEATED messages is included in 
the line count. 



NR 
Example: 



Do not rewind file lfn. before dump (default is to rewind lfn,). 



Two lines, each containing the alphabet, were input to file X from a time- sharing 
terminal. File X was dumped to file Y producing the following output. 

• FILE DUMP - TDUHP,IrX,L*T. 78/10/23. 08.05.51. MGE 1. 

FID II 0- 0102 0304 050$ 0710 1112 1311 1516 1720 2122 2324 2526 2730 3132 0000 0000 0102 0304 0506 0710 1112 

ABCDEFG8IJ U III OP tl SI UTVXTZ 1BCDEFGHIJ 

Fit II 4. 1314 1516 1720 2122 2324 2526 2730 3132 0000 0000 

EL HI OP 08 ST UVHXYZ 

— EK0 OF RECORD ~ 

~ E1D OF IIFORMTIOR — 

— EID OF DUHF — 

The prefix 

F 1 R 1 W 

means file 1, record 1, word 0, The zeros following each alphabet indicate the end of 
a terminal line. 



UNLOAD STATEMENT 

The UNLOAD control statement releases files assigned to the job and may release file space 
(depending on the file type). 

The control statement formats are: 

UNLOADOfn^ lfry .... lfn Q ) 

or 

UNLOADS, lfn. , lfn. lfn ) 

i i n 

The first format unloads the named files (lfn,, lfn 2 , . . . , lfn_). The second format unloads 
all files assigned to the job except the named files. If no fues are named on the second 
format, the asterisk specification unloads all files assigned to the job. 

The UNLOAD statement performs the same function as the RETURN control statement 
except as noted below. Refer to the description of the RETURN statement given earlier in 
this section to determine the operation performed for each file type. 
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The UNLOAD statement differs from the -RETURN statement if the file being unloaded is a 
magnetic tape file or a direct access file residing on an auxiliary removable pack and the 
job requires more than one tape or pack resource concurrently. In this case, the UNLOAD 
statement does not decrease the number of tape /pack resources scheduled for the job with 
the RESOURC control statement. 

For magnetic tape files, if the previous operation was a write, the UNLOAD statement - 
causes the following operations to be performed. 

• If the tape is ANSI labeled, the system writes a tape mark, an EOF1 label, and 
three tape marks and then unloads the tape. 

• If the tape is unlabeled and the data format specified on the ASSIGN, LABEL, or 
REQUEST card is S, L, or P, the system writes four tape marks and then unloads 
the tape. 

• If the tape is unlabeled and the data format is I or SI, the system writes a tape 
mark, an EOF1 label, and three tape marks and then unloads the tape. 

I Refer to Magnetic Tape Files in section 2, and Tape Management control statements in 
section 10 for further information about tape files and to appendix G for a description of an 
EOF1 label. v 

UNLOCK STATEMENT 

The UNLOCK control statement rescinds the LOCK command and clears the write interlock 
bit for the specified file. 

The control statement format is: 

UNLOCK(lfn r Ifrig. . . . , lfn Q ) 

Ifnj Name(s) of local file(s) 

The file must be a local file; if it is not, the following message is issued. 

ILLEGAL FILE TYRE. 
Library files cannot be unlocked. 



* 
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VERIFY STATEMENT 

The VERIFY routine performs a binary comparison of all data from the current position 
of the files specified. The comparison is meaningful if the files are within the range of 
compatible formats listed in table 1-7-2. 

The control statement format is: 

VERIFY (lfnj, lfn 2> Pj, P 2 » . . . , p Q ) 

lfn. Name of the first file; if this parameter is omitted, TAPE1 is assumed. 

lfru Name of the second file; if this parameter is omitted, TAPE2 is 

assumed. 

p. Any of the following in any order: 

N=0 Verify terminates on me first empty file encountered 

on either file. 

N=x Verify x files; default is N=l. 

N Verify terminates when end of information is en- 

countered on both files. 

E=y List the first y errors encountered on the comparison. 

If E is omitted, the system assumes E=100. 

E Same as E=0, no errors are listed. 

L=lfn„ List errors on file If no. If L is omitted, the system 

* assumes LOUTPUT. 

A Abort after verify completed if errors occurred. 

R Rewind both files before and after the verify. 

C Coded file mode is set on both files. This is 

applicable only to S and L format tapes. If 
coded mode is set on an SI tape, the system 
aborts the job. 

CI Coded file mode is set on the first file only. 

This is applicable only to S and L format tapes. 
If coded mode is set on an SI tape, the system 
aborts the job. 

C2 Coded file mode is set on the second file only. 

If coded mode is set on an SI tape, the system 
aborts the job. 

BS=bsize Defines the maximum block size (PRU size) in 

central memory words for an S or L tape. This 
parameter is legal only for S and L tape verifies. 
The default for an S tape is 1000_ words, and for 
an L tape, it is 2000 g words. 
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Whenever words on lfr^ and lfn 2 do not match, VERIFY lists the following. 

• Record number 

• Word number within the record 

• Words from both files that do not match 

If excess records are encountered on lfnj or lfn,, the following message is listed. 

n EXCESS RECORD(S) ON Ifn. 

n is the decimal number of excess records. The title line of the error list file contains 
the decimal number of the logical file being verified. If a nonstandard file (one in which an 
EOI or EOF is not preceded by an EOR) is compared with a standard file, VERIFY lists 
the following message. 

r £i\jxi jyuaoiiNU \jn un 

r Record number in decimal 

Ifn Name of the nonstandard file 

If EOI is encountered on one input file (lfni or lfn 2 ) and there are still files remaining on 
the other input file, each excess file generates the following message. 

n RECORD(S) IN EXCESS FILE m ON Ifn. 
n is the decimal number of excess records in logical file number m. 
If errors are encountered, the following warning message is issued to the user's dayfile, 

VERIFY ERRORS. 
If any pair of lfnj, lfng, and lfng are identical, the following fatal message is issued. 

FILE NAME CONFLICT. 
If lfnj or lfn 2 did not exist prior to the verify, the following warning message is issued. 

FILE NOT FOUND - Ifn. 
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In a verify operation involving S, L, or P format tapes, VERIFY first clears the extraneous 
data in the last word of each block (as specified by the byte count and the unused bit count) 
and then makes the comparison. On these formats, every block is considered a record 
(returns EOR status). 

If a verification of an L or F format tape requires additional field length, VERIFY increases 
the field length as needed. If the field length requirement exceeds the user's maximum 
field length, the verify is aborted with the error message: 

VERIFY FL ABOVE USER LIMIT. 

The maximum block size for an L format tape is specified by the BS=keyword or its default. 
The maximum block size for an F format tape is calculated from the frame or character 
count specified on the control statement when the file is assigned. 

A verify operation is not guaranteed when the logical structure of the two files is incompat- 
ible. Before VERIFY makes a comparison of such files, it issues the warning message: 

FILE STRUCTURES NOT COMPATIBLE. 
TABLE 1-7-2. COMPATIBLE FILE STRUCTURES FOR THE VERIFY STATEMENT 



OUTPUT MEDIA FORMAT 



INPUT 
MEDIA 
FORMAT 





Mass 
Storage 


Tape Formats 




I 


SI 


S 


L 


F 


Mass Storage 


Yes 


Yes 


Yes 


No 


No 


No 


T 
A 
P 

E 

F 
O 

R 

M 
A 
T 
S 


I 


Yes 


Yes 


Yes 


No 


No 


No 


SI 


Yes 


Yes 


Yes 


No 


No 


No 


S 


No 


No 


No 


Yes 


No 


No 


L 


No 


No 


No 


No 


Yes 


No 


F 


No 


No 


No 


No 


No 


Yes 



NOTE 



The No entries indicate that the logical structures of the 
files compared are incompatible. VERIFY may accept 
those combinations, but the results require the user to 
make a knowledgeable correlation of results with the 
format descriptions in section 10. In some cases, the 
verify of an incompatible pair may result in a VERIFY 
GOOD message; otherwise, a VERIFY ERRORS message 
is listed. 
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WRITEF STATEMENT 

The WRITEF control statement directs the system to write a specified number of file marks 
on the named file. 

The control statement format is: 

WRITEOfn.x) 

lfn Name of the file to be written on. 

x Number of filemarks to be written; if this parameter is omitted, 

the system assumes x=l. 

If the last operation to the file was a write that did not end with the writing of an EOE or 
EOF, WRITEF writes a record mark before it writes the specified number of file marks. 
For all other cases, WRITEF, writes the file marks without a preceding record mark. 

WRITER STATEMENT 

The WRITER control statement directs the system to write a specified number of empty 
records on the named file. • 

The control statement format is: 

WRITER (lfn, x) 

tfn Name of the file to receive the empty records. 

x Number of empty records to be written; if this parameter is omitted, 

the system assumes x=l. 
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PERMANENT FILE CONTROL STATEMENTS 8 



The permanent file control statements allow the user to utilize the permanent file system, f 
The control statements included in this category are: 

SAVE 



APPEND 


DEFINE 


PERMIT 


ATTACH 


GET 


PURGALL 


CATLIST 


OLD 


PURGE 


CHANGE 


PACKNAM 


REPLACE 



The statements described in the following section allow the user to create permanent files 
(DEFINE) and make local files permanent (SAVE, REPLACE). These files can be 
accessed (ATTACH, OLD, GET), added to (APPEND), and released (PURGE. PURGALL). 
Requests are directed to a specified auxiliary device by the PACKNAM statement. Certain 
parameters can be changed with the CHANGE statement without attaching and redefining 
the file or retrieving and saving it. 

Information on permanent files is obtained through the CATLIST statement. Part of that 
information is the permission status of the user as granted by another user by means 
of the PERMIT statement. 

The following pages list options available on the control statements. Unless otherwise 
stated, the options described apply to all of the permanent file control statements. All 
file names must be 1 to 7 alphanumeric characters. For a detailed description of 
permanent file structure, refer to section 2. Errors encountered during permanent 
file control statement processing cause error messages to be issued to the user's day- 
file. For a description of these messages, refer to appendix E. 



■f The batch user cannot access permanent files unless he has included a USER statement 
in the job deck. 
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Keyword 

UN= 



Option 



usernum 



Description 

Alternate user number. This parameter is neces- 
sary only if the permanent file involved resides in 
another user's catalog. To be able to access other 
catalogs, the user must be granted explicit per- 
mission (refer to the PERMIT control statement), 
the file must be a semiprivate or public file, or 
the user must have automatic permission. A user 
has automatic permission to files in catalogs of 
other users if his user number contains asterisks, 
and all nonasterisk characters match the other 
user's user number. 



PW= 



passwrd 



The UN keyword is used to establish alternate 
access validation (that is, PERMIT checking and 
catalog mode /category checking) even if the speci- 
fied user number is the one under which the job 
is currently being run. 

The user has the option of specifying a 1- to 7- 
character password for a file. This password 
must be specified whenever alternate users access 
the file. 



PW 



CT = 



ct 



The user has the added security of specifying a 1- 
to 7 -character password for a file by including it 
as a single-line record in the INPUT file. This 
password must be specified whenever alternate 
users access the file. 

Permanent files fall into three categories which 
specify the method of access. This option must 
be selected when the file is saved, defined, or 
changed. The categories are: 



P 

or 

PRIVATE 



Private files are available for 
access only by the originator or 
those to whom the originator has 
explicitly granted permission (re- 
fer to the PERMIT control 
statement) . 



S 

or 

SPRIV 



PU 
or 

PUBLIC 



Semiprivate files are available for 
access by all users who know the 
file name, user number, and 
password. The system records 
in the originator's catalog the 
user number of each user who 
accessed the file, the number of 
accesses, and the date and time 
of the last access. 

Public files are available for ac- 
cess by all users who know the 
file name, user number, and pass- 
word. The system records the 
number of times the file was ac- 
cessed but does not record user 
numbers or the last access date 
and time. 
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Keyword 

M= 



Option 
m 



Description 

Permanent file or user permission modes: 

E Allows the user to execute the 

or file. To execute a file assigned 

EXECUTE to the user's job in EXECUTE 
mode, the file must either be in 
absolute format or in a relocat 1 
able format that can be loaded 
and executed via a file name call 
statement (such as LGO) which 
is not preceded by a loader con- 
trol statement. 

R Allows the user to read and/or 

or execute the file. Up to 63 users 

READ can access a file concurrently in 

R mode. 

RA Allows the user to read and /or 

or execute the file. For indirect 

READAP access files, RA permission is 
the same as R permission. For 
direct access files, it allows the 
user to read and /or execute the 
file while another user is con- 
currently accessing the file in 
APPEND mode. Up to 63 users 
can access a file concurrently in 
RA mode. 

RM Allows the user to read and /or 

or execute the file. For indirect 

READMD access files, RM permission is 
the same as R permission. For 
direct access files, it allows 
the user to read and /or execute 
the file while another user is 
concurrently accessing the file 
in MODIFY or APPEND mode. 
Up to 4095 users can access a file 
concurrently in RM mode. 

A Allows the user to read, exe- 

or cute, and/or append the file. 

APPEND Appending a file means adding 
data at the end of the file (EOI). 
Data within the original file 
boundaries cannot be changed. 

M Allows the user to read, execute, 

or append, and/or modify the file. 

MODIFY For indirect access files, MODI- 

FY permission is the same as 
APPEND permission. For di- 
rect access files, MODIFY per- 
mission means that the file can 
be changed or lengthened but not 
shortened. 
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Keyword Option Description 

W Allows the user to read, execute, 

or append, modify, write, and /or 

WRITE purge the file. The file can be 

shortened, lengthened, or 

replaced. 

N Removes permission previously 

or , granted via PERMIT control 

NULL statements. 

Special care should be taken when using READMD or READAP mode. Programs using 
access techniques (either the input /output macro or CYBER Record Manager) which do not 
expect concurrent updating of a file may get erroneous results if these modes are used. 

CYBER Record Manager Advanced Access Methods (refer to the AAM Reference Manual) 
does not anticipate concurrent updating of a file by another user. Therefore, if a file has 
been attached in either READMD or READAP mode and these access methods are beini* 
used, a warning diagnostic message is issued stating that the file is bad when, in fact,°it 
is not. 



Keyword Option Description 

ss= subsystem Specifies the time-sharing subsystem to be associ- 

ated with the file. One of the following subsystems 
or its abbreviation may be specified on a SAVE or 
CHANGE control statement. 



BASIC 
BATCH 

EXECUTE 
FORTRAN 
FTNTS 
NULL 



Meaning 


Abbreviation 


BASIC subsystem 


BAS 


Batch subsystem 


BAT 


Execute subsystem 


EXE 


FORTRAN 5 


FOR 


FORTRAN Extended 4 


FTN 


NULL subsystem 


NUL 



In batch jobs, if the SS parameter is omitted or 
specified without a subsystem, the NULL subsystem 
is associated with the file. 

In time-sharing jobs, if the SS parameter is speci- 
fied without a subsystem, the currently active sub- 
system is associated with the file. If the SS param- 
eter is omitted, the NULL subsystem is associated 
with the file, unless the file is the primary file. In 
that case, the current subsystem is associated with 
the file. 
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Keyword 



PN = 



Option 
packname 



S= 



space 



Description 

A 1- to 7-character pack name used in conjunction 
■with the R keyword to identify the auxiliary device 
to be accessed in the permanent file request. This 
parameter is specified only when the file to be 
accessed resides on an auxiliary device. If the 
device is currently not available and the NA key- 
word was not specified, the following message is 
issued to the user's dayfile. 

DEVICE UNAVAILABLE, AT nnn. 

An auxiliary device is a mass storage device that 
supplements the normal family of permanent file 
devices. A RESOURC control statement must be 
included in any job that uses two or more disk 
packs concurrently. 

Specifies the amount of space in decimal PRUs 
desired for the direct access file. Refer to the 
DEFINE control statement. 

Specifies the type of device on which the permanent 
file resides or is to reside; r can be any of the 
following. 



r Device 

DE Extended Core Storage t 

Dli 844-21 Disk Storage Subsystem 

(l£i£8) (halftrack) 

DJi 844-4x Disk Storage Subsystem 

(l^i^8) (haLf track) 

DKi 844-21 Disk Storage Subsystem 

(l^i^8) (full track) 

DLi 844-4x Disk Storage Subsystem 

(l£i£8) (full track) 

DMi 885 Disk Storage Subsystem 

(l£i£3) (half track) 

DQi 885 Disk Storage Subsystem 

(l£i£3) (full track) 

DP Distributive Data Path to ECSf 

The R keyword can be used in two ways. 

• It can be used on the DEFINE control state- 
ment to specify the family device on which 
the direct access permanent file is to reside. 



t The job must be of system origin or the user must be validated for system origin 
privileges. 
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Keyword Option Description 

• It can be used in conjunction with the PN and 
NA keywords on any permanent file control 
statement (including DEFINE) to identify the 
auxiliary device on which the permanent file 
resides or is to reside. R is required only 
if the desired device has a device type differ- 
ent from that of the default device type and the 
installation has defined the desired device as 
removable. If PN and NA are specified but R 
is not specified, the system default device type 
is used. If the specified device type cannot be 
recognized or does not exist in the system, 
the following message is issued to the user's 
dayf ile . 

ILLEGAL DEVICE REQUEST, AT nnn. 

NA The NA keyword can be used in two ways. 

• Normally, if the user attempts to access a 
file that is interlocked or if an error occurs 
in an attempt to process the file, the system 
aborts the job. With the NA option, the user 
can bypass a job abort and continue processing. 
If lfn is busy and the NA option is specified on 
an ATTACH control statement, the system 
automatically suspends the job until the file 
becomes available. If NA is specified and an 
error other than pfn BUSY occurs in process- 
ing file lfni, the system issues the appropriate 
error message to the user's dayfile and then 
continues with file lfnj+1 . If the error oc- 
curred on the last file specified on the state- 
ment, the system continues with the next 
statement. 

• If the user requests an auxiliary device that 
is currently not available, the system aborts 
his job. The NA keyword enables him to by- 
pass this abort and direct the system to make 
the desired device available. 

ND The ND keyword prevents releasing of the files 

assigned to the job upon processing of an OLD 
control statement. 

Several files can be accessed with one control statement. A slash (/) is used to separate 
the files being accessed and the options described previously. The special options are 
order- independent and are indicated by the keywords described. If special options are 
specified on the control statement, they apply to all files that appear on the statement 
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APPEND STATEMENT 

The APPEND control statement allows the user to add supplementary information to an 
existing indirect access file. 

The control statement format is: 

APPEND(pfn, lfn lf lfn 2 , .... lfn n /PW=passwrd, UN=usernum, PN=packname, R=r, NA) 

pfn Name of the indirect access permanent file to which the local files 

are to be appended. 

lfn. Name(s) of local file(s) to be appended to pfn. 

The logical structure of the two files is retained; that is, EORs and EOFs are appended 
as well as data. If the file is appended to a file in an alternate user's catalog, a 
password must be supplied if one is required. 



ATTACH STATEMENT 

The ATTACH control statement allows a user to access a direct access file. 

The control statement format is: 

ATTACH (lfn j =pfnj, Ifn^pfn,, . . . , lfn n =pfn n /UN=usernum, PW=passwrd, M=m, 
PN=packname, R=r, NAF 

lfn. Local file name given to the direct access file while it is 

1 attached to the user's job. A working copy is not generated 

since user access is made directly to the permanent file. 
Thus, lfni is used only when it is desirable to reference the 
attached file by a name other than its permanent file name, 
pfn.. The local file name is returned to the system if it is 
already present when this statement is issued, even if an error 
is encountered in processing the statement. 

pfn. Name of direct access file to be attached. If pfn. is omitted, 

the system assumes pfn.=lfn,. l 

m File or user permission mode, where m can be W, M, A, E, 

R, RM, or RA. If m is omitted, the system assumes m is 
R. This option must be specified by all users, including the 
originator, if the file is to be modified or new information is 
to be added to the file. If pfn. is attached in W mode, the 
date is recorded as last modification date even if the file was 
not altered. 

A read/write interlock controls multiple access of a direct access file. The main pur- 
pose of this interlock is to ensure that only one user at a time writes on the file; 
however, it is possible for several users to read a file simultaneously. 
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Table 1-8-1 gives combinations of multi-pie access. The left column specifies the cur- 
rent access status of the file, and the top row indicates the type of access a user is 
requesting on an ATTACH statement with the M parameter. The entries in the table 
are the access modes actually granted. The access a user is granted is contingent on 
having been permitted that mode of access by the creator of the file. 



TABLE 1-8- 


•1. COMBINATIONS OF MULTIPLE ACCESS 




Current 
Access 


Access Requested 


Free 
W 


W 


M 


A 


R 


RM 


RA 


E 


Busy 


Busy 


Busy 


Busy 


Busy 


Busy 


Busy 


M 


Busy 


Busy 


Busy 


Busy 


M/R 


Busy 


Busy 


A 


Busy 


Busy 


Busy 


Busy 


A/R 


A/R 


Busy 


xv 


Busy- 


Busy 


Busy 


T"» 

XV 


R 


XV 


R 


RM 


Busy 


M/R 


A/R 


R 


R 


R 


R 


RA 


Busy 


Busy 


A/R 


R 


R 


R 


R 


E 


Busy 


Busy 


Busy 


R 


R 


R 


R 






11 






Inote 


W, M, A, R, RM, RA, and E have the values described under the M= keyword. 


Busy indicates the requested access is not allowed while the current access is in 
effect. 


A/R is the access condition in which one user has attached the file in append 
mode, and one or more other users have attached it in read mode. 


M/R is the access condition in which one user has attached the file in modify 
mode, and one or more other users have attached it in read mode. 



If a file is to be accessed by alternate users, it should be returned as soon as possible. 

If an auxiliary device has been previously specified by a PACKNAM statement, the 
system attempts to attach pfnj from the auxiliary device rather than the normal system 
devices. 
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CATUST STATEMENT 

The CATLIST control statement lists information about the user's permanent files or those 
permanent files he can access in the catalogs of alternate users . 

The control statement format is: 

CA TLIST(LO=p, FN =pfn, UN =usernum, PN =packname, R =r, L =lfn, NA , DN =dn) 

LO=p One of the following list options (default is 0): 

F Lists pertinent information about each file in the user's 

catalog. The final two lines give the number of indirect 
access files, the number of direct access files, and the 
total PRUs used by each type. 

If an alternate user number is specified (UN option), 
the user obtains a listing of all files that he can access 
in the alternate user's catalog. The password for files 
in an alternate user's catalog is not included in the 
listing. The password to files in an alternate user's 
catalog must be obtained directly from that user. 

FP Lists the permission information recorded for each 

alternate user of a specified file in the user's catalog. 
This option requires that a file name be specified (FN 
option). If an alternate user number is specified (UN 
option), only the permission information for that user 
of the specified file is listed. 

The user numbers listed include those that have been 
granted explicit permission to the file (private file only) 
and those that have accessed the file because of implicit 
permission (semiprivate files only).t An asterisk (*) 1 
follows the user number /permission mode if explicit 1 

permission has been granted this user. I 

Lists alphabetically by column the names of the in- I 

(zero) direct access files and the names of the direct access I 
files in the user's catalog. If an alternate user number | 
is specified (UN option), the user obtains only the names 
of the files that he can access in the alternate user's 
catalog. If no LO keyword is specified, the system 
assumes this value. 

An asterisk (*) preceding a file name indicates an error 
status is set in the catalog entry for the file. The cause 
of the error may be one of the following. 

• EOI was altered during mass storage recovery, j 

• BOI/EOI verification error. 

• Error in data and /or permit entries. 

To clear an error status flag, refer to the CHANGE I 

statement in this section. I 



tUser numbers are not recorded for accesses to public files. 
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P Selepts a short list that indicates only the user numbers 

of alternate users who have access to the specified pri- 
vate or semiprivate file. This option requires that a 
file name be specified (FN option). 

PN=pfn Permanent file name. If pfn contains no asterisks, this option 

requests catalog information only for the permanent file pfn. 
This parameter is required when listing permit information 
(the LO=FP and LOP list options). If a short list option is 
selected (LO=0 or LOP), the message 

pfn FOUND;, ATnnn. 
is issued if the file (or user number) is located. The message 

pfn NOT FOUND, AT nnn. 

is issued if the file (or user number) is not located. 

If pfn contains one or more asterisks, CATLIST lists catalog 
information for the subset of files whose names contain the 
same letters in the same positions as specified in pfn. For 
example, FN=***OPL lists all 6-character file names ending 
in OPL. FN=M****** lists all files whose names start with the 
letter M. The asterisk is invalid when listing permit informa- 
tion with the LO=FP or LO=P list options. 

UN=usernum User number. This parameter has two purposes. 

• For LO=F and LO=0. Indicates the alternate catalog for 
which the user desires catalog information. 

• For LO=FP and LO=P. Indicates the permission informa- 
tion recorded for the specified alternate user. 

PN=packname This parameter specifies an auxiliary device that contains 

catalog information for all users with files on that device. 
The PN keyword must be specified if the user wishes to obtain 
the following information from his catalog on the specified 
auxiliary device. 

• Pertinent information about each file (LO=F). 

• Only the name of each file (LO=0). 

• Permission information for each alternate user that has 
accessed a specific file (LO=FP). 

• Only the user number of each alternate user that has 
accessed a specific file (LO=P). 

The PN parameter can also be specified to allow alternate 
users to obtain a list of files they can access on the auxiliary 
device, as well as pertinent information about each file. 
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£ =r Device type on which permanent file catalog resides. Used in 

conjunction with the PN and NA parameters. Refer to R param- 
eter description at beginning of this section. 

L=lf n Output file name. This is the name of a local file to which the 

CATLIST information is written. If this parameter is omitted, 
the system assumes L OUTPUT. If lfn exists and is positioned 
at BOI, the contents of that file is purged before the CATLIST 
information is written. However, if lfn exists and is positioned 
at EOI, the CATLIST information is appended to the file as a 
new logical record. 

NA No abort option. CATLIST continues processing if errors 

are encountered during processing. 

DN=dn Device number (0 through 77 8 ). List file residing on specified 

device number dn. 

If no entries are present in the specified catalog, the message 

EMPTY CATALOG. 
is issued to the user's dayfile. 
Example: 
A user entered the following statement 

CATLIST. 
and received the following listing of his permanent files. 

CATALOG OF USERNUM FM/FAMNAHE 79/05/14. 10.37.26. 

INDIRECT ACCESS FILE(S) 

COWER FJOB LFILE PR0C12 PR0C13 TESTA ZZZDUMP 

DJOB FORT 

DIRECT ACCESS FILE(S) 

DATAB LIB5 TESTLIB TEST2 

9 INDIRECT ACCESS FILE(S), TOTAL PRUS = 19- 

4 DIRECT ACCESS FILE (S), TOTAL PRUS = 4. 

The heading gives the user number, the device family name, and the date and time. If 
the PN=packname parameter was specified, the family name in the heading is replaced by 
PN/packname. 

CHANGE STATEMENT 

The CHANGE control statement allows the creator of a direct or indirect access permanent 
file to change one or more of its characteristics without assigning the file to his job. A 
direct access file need not be attached and redefined; an indirect access file need not be 
retrieved and replaced. 
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The control statement format is: 

CHANGE(nfn=ofn/CT=ct,M=m,PW=passwrd,SS=subsystem,PN=packname,R=r,NA,CE) 
The full descriptions of the statement parameters are given at the beginning of this section, 
nfn New permanent file name. 

ofn Old permanent file name. If no name change is desired, only 

ofn is specified. 

CT=ct New access category for the file (private, semiprivate, or public). 

M=m New alternate user permission mode. 

PW=password New password. If PW=0 is specified, CHANGE clears the old 
password without setting a new password. 

33=subsystem New time-sharing subsystem to be associated with the file. 

PN=packname Auxiliary pack on which the file resides. This parameter cannot 
specify a new file residence. 

R=r Device type on which the file resides. This parameter cannot 

specify a new file residence. 

NA If the requested auxiliary pack is not available, the job is sus- 

pended until the pack becomes available. 

CE Clear file error code. For further information, refer to section 

5 in volume 2. 

CHANGE also updates the last modification date and last access date for the file. 

DEFINE STATEMENT 

The DEFINE control statement allows the user to define direct access permanent files. 
The control statement format is: 

DEFINE(lfn 1 =pfn 1 ,lfn 2 =pfn 2 , . . . ,lin n =pfn n /PW=passwrd,CT=ct,M=m,R=r, 
S=space,PN=packname,NA) 

The full descriptions of these parameters are given at the beginning of this section. 

tf n i ^ DEFINE creates an empty direct access permanent file, lfn- 

is specified only if the user desires to reference the file by a l 
name other than its permanent file name. If DEFINE defines an 
existing local file as a direct access file, lfn^ is the name of the 
local file. Also, if lfn^ exists, its position is not altered. 

P fn i Permanent file name. If pfni is omitted, the system assumes 

lfni=pfni. 

PW=passwrd Password required to access the defined file. 

CT=ct Access category of the defined file (private, semiprivate, or 

public). 
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M=m 



R=r 



Alternate user, permission mode. This does not affect the current 
mode. After defining a file, the user is always in write mode. 

Type of device on which the permanent file is to reside. The 
device must be a permanent file mass storage device on which 
direct access files are allowed. 

Number of PEUs requested for the file. 

Name of the auxiliary pack on which the direct access file is to 
reside. 

If the requested auxiliary pack is not available, the job is sus- 
pended until the pack becomes available. 

The user can either create an empty permanent file or define an existing local file as a 
direct access file. If the user releases the file and wishes to access it at some time 
in the future, the ATTACH control statement must be included. 

If Ifn- does not exist, the device on which pfnj resides depends on the r and space 
parameters. 



S=space 
PN=packnam 

NA 



Specified 
Specified 



space 
Not specified 

Specified 



Not specified Specified 



Not specified Not specified 



Residency 

The file resides on the device of type r with 
the most space available. 

The file resides on the device of type r with 
the most space available, provided that 
device has as many PRUs available as speci- 
fied by the space parameter. 

The file resides on the device with the most 
space available, provided that device has 
as many PRUs available as specified by the 
space parameter. 

The file resides on the device with the most 
space available. 



If an auxiliary device has been previously specified by a PACKNAM statement, pfr^ resides 
on that auxiliary device rather than a system device. 

If the optional parameters are omitted, the system assumes the following values. 

Keyword Default 



PW 


None 


CT 


PRIVATE 


M 


WRITE 


PN 


None 
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If the S option is selected and no device has the specified amount of space available, the 
request is aborted and the following message is issued to the user's dayfile. 

PRUS REQUESTED NOT AVAILABLE, AT nnn. 

Unused space is not guaranteed to be available if the user attempts to expand the file at a 
later time. 

If lfn£ already exists on a device other than that specified by r, or an illegal device is spec- 
ified, the system issues the following message to the user's dayfile. 

DIRECT ACCESS DEVICE ERROR, AT nnn. 

GET STATEMENT 

The GET control statement enables the user to retrieve a copy of file pfn. for use as a local 
file. 1 

The control statement format is: 

GETGfnj^pfhj, lfn 2 =pfn 2 , . . . , lfn =pfn /UN=usernum, PW=passwrd, PN=packname, 
R=r,NA) 

lfn. Local file name given the file while in use. 

pft^ Permanent file name; if pfn. is omitted, lfn.=pfn.. 

If the request is made with no parameters specified, the user's primary file is assumed. 

Each pfn specified must be an indirect access file. File lfr^ is returned to the system if it 
is present before this command is issued even if an error is encountered in processing the 
command. The new file is rewound. No interlock is provided to prevent other users from 
obtaining working copies of the same file simultaneously. If the name of the user's current 
primary file is specified as an lfn, the corresponding pfn is made the new primary file 
and any subsystem associated with it becomes the user's new current time-sharing sub- 
system (refer to the IAF Reference Manual or the Time-Sharing User's Reference Manual). 

If the request is for a file in another user's catalog (UN option specified), the permission 
mode must allow the user to read the file. 

If an auxiliary device has been previously specified by a PACKNAM statement, the system 
attempts to retrieve the copy of pfn. from the auxiliary device rather than the normal 
system devices. 

OLD STATEMENT 

The OLD control statement retrieves a copy of a permanent file and makes it the primary 
file. 

The control statement format is: 

OLD<]in=pfWUN=usernum, PW=passwrd, PN=packname, R=r,NA, ND) 

lfn Local file name given the file while in use. 

pfn Permanent file name. If pfn is omitted, lfn=pfn. 
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The OLD statement performs the same -operation as the GET statement and additionally 
makes lfn the primary file. Any currently existing primary file is released. All * 
files assigned to the job are released unless the ND parameter is specified. 

If an auxiliary device has been specified previously by a PACKNAM statement, the 
system attempts to retrieve the copy of pfn from the auxiliary device rather than the 
normal system devices. 

Refer to the note in PRIMARY Statement. in section 7 for use of the primary file type. 

PACKNAM STATEMENT 

The PACKNAM control statement directs subsequent permanent file requests to the 
specified auxiliary device. 

The control statement format is: 

PACKN AM(PN =packname) 

or 

PACKN AM (packname) 

packname A 1- to 7-character name used to identify the 

auxiliary device to be accessed in subsequent 
permanent file requests. 

PACKNAM allows the user to omit the PN keyword from requests for files that reside 
on the specified device. However, if permanent files on another auxiliary device are 
to be accessed, the PN keyword can be specified in the request or another PACKNAM 
request can be issued. Refer to Mass Storage File Residence in section 2 for information I 
concerning auxiliary permanent file devices. ■ 

The user cannot access permanent files residing on the normal system devices while 
the PACKNAM request is in effect. To access these files, he must include a PACK- 
NAM statement in either of the following formats. ■ 

PACKNAM. 

or 
PACKN AM (PN=0) 
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PERMIT STATEMENT 

The PERMIT control statement allows a user to explicitly permit another user to access a 
private or semiprivate file in his permanent file catalog. 

The control statement format is: 

PERMIT (pfn, usernum 1 =m 1 , us emum 2 =m 21 ..., usernum=m/PN =packname, R=r, NA) 

pfn Permanent file name. 

usernum.. User number to be permitted access to pfn. 

m. Permitted mode Of access. If m. is omitted, the system 

assumes mode R. (The access modes are defined at the 
beginning of this section.). 

If pfn is a public file, the following message is issued. 

PFM ILLEGAL REQUEST, AT nnn. 

PURGALL STATEMENT 

The PURGALL control statement purges all permanent files in the user's catalog that satisfy 
the criteria specified by the parameters. 

The control statement format is : 

PURGALL(CT=ct, AD=ad, MD=md, CD=cd, DN=dn, TY=ty, TM=tm, PN=packname, R=r, NA) 

ct File category. 

ad Last access date; format of date is yymmdd. 

md Last modification date; format is yymmdd. 

cd Creation date; format is yymmdd. 

dn Device number <0 through 77o). The device number is 

assigned during system configuration time when the device 
is defined. It uniquely identifies a device within a family, t 

ty File type: 

I 

or Purge all indirect access files 

INDIR 

D 

or Purge all direct access files 

DIRECT 

A 

or Purge all files 

ALL 

If this parameter is omitted but other parameters are 
specified, the system assumes ty is ALL. If no other 
parameters are specified and the user wishes to purge 
all files, he must specify TY=A. 

tm Time of day on the date specified by ad, md, or cd 

parameter. The time of day is expressed in the format 
hhmmss. 



t Refer to section 2 for further information about families of permanent file devices. 
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packname Name of auxiliary device on which the files to be purged 

reside. The PN option cannot be selected if a device num- 
ber was specified. 

r Type of auxiliary device on which the files to be purged 

reside. The R option cannot be selected if a device num- 
ber was specified. 

The AD, MD, and CD keywords are used to purge any files whose last access, last 
modification, or creation occurred before the specified date. To purge all files in his 
catalog, the user must enter: 

PURGALL(TY=A) 

CT, DN, TY, TM, and either AD, MD, or CD may be entered simultaneously. 



PURGE STATEMENT 

The PURGE control statement names files to be removed from the permanent file 
device. 

The control statement format is: 

PURGE(pfnj, pfn,, . . . , pfn /UN=usernum, PW=passwrd, PN=packname, R=r, NA) 

pfn. Permanent file name. 

If the request is made with no parameters specified, the user's primary file is assumed. 

When a PURGE command is issued for a direct access file which is not being used, the 
file is purged and the permanent file catalog is altered accordingly. If the direct access 
file is in use, the catalog is altered to reflect purging of the permanent file but the 
actual file is not purged until the last user returns it. 

To purge a file in an alternate user's catalog, one of the following must be true. 

• The file is private and the user has write permission. 

• The file is public with write mode. 

• The file is semiprivate and the user has write permission. 

• The file is semiprivate with write mode and the user has not explicitly been 
permitted access to the file. 

If pfn^ does not exist, the following message is issued. 

pfn NOT FOUND, AT nnn. 
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REPLACE STATEMENT 

The REPLACE control statement enables the user to place a copy of a local file in the 
permanent file system as an indirect access file. 

The control statement format is: 

REPLACE(lfni=pfni, Ifn2=pfn2, .... lfn =pfn /UNmsernum, PW=passwrd, 
PN=packname, R=r, ) n n *» 

lfn. Local file name. 

Pf n i Permanent file name. If pfn. is omitted, lfn.=pfn. . 

If the request is made with no parameters specified, the user's primary file is assumed. 

If pfn. already exists, it is purged and replaced by the new file. The new file is in 

the same catefforv as thf> file it: runlnnori Tf nfn rinoc n^t o«i<<t *u« ->»— «i- -•- -.- 3 

as a private file. "^The specified local files are rewound before and after the replace 
operation. Permission information and alternate user access data for the file are not 
lost when a file is replaced. 

A user who has been granted write permission to another user's file can replace that 
file only if he is validated to create indirect access permanent files (refer to LIMITS 
control statement in section 6). ■* 



SAVE STATEMENT 

The SAVE control statement allows the user to retain a copy of a local file as an 
indirect access file. 

The control statement format is: 

SAVE(lfni=pfni. Ifn2=pfn2, . . . , lfn =pfn /PW=passwrd, CT=ct, M=m, SS=subsystem, 
PN=packname,R=r,NA) n n 

lfn^ Local file name. 

P fn i Permanent file name. If pfn. is omitted, the system 

assumes lfn^pfn,. 

If the request is made with no parameters specified, the user's primary file is 
assumed. If the name of the user's current primary file is specified as an lfn, the 
user's current subsystem is stored in the file's catalog entry. 

The specified local files are rewound when the save operation is completed. If the 
optional parameters are omitted, the system assumes the following values. 

Parameter Default 



PW=passwrd No password. 

CT=ct Private access category. 

M=m WRITE alternate user permission. 
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Parameter 



SS=subsystem 



Default 

NULL subsystem, unless lfn is the primary file in a time-sharing 
job. The subsystem is then set to the currently active subsystem. 



PN=packname The file does not reside on an auxiliary pack. 

The full descriptions of the statement parameters are given at the beginning of this section. 

If an auxiliary device has been previously specified by a PACKNAM statement, the 
system saves pfn^ on the auxiliary device rather than a normal system device. If 
pfn^ already exists in the user's catalog, the following message is issued. 

pfn ALREADY PERMANENT, AT nnn. 



ERROR CONDITIONS 

Table 1-8-2 specifies the action PFM takes if it detects an error while reading mass 
storage. The symbols used in the table designate the response PFM makes and are 
defined as follows: 



Symbol 
DTE 
EOI 
MSE 
FNF 
DAF 
FLE 



Description 
DATA TRANSFER ERROR. 

Processing continues as if an EOI was encountered. 
MASS STORAGE ERROR. 
pfn NOT FOUND. 
DIRECT ACCESS FILE ERROR. 
FILE LENGTH ERROR. 
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LOAD/DUMP CENTRAL MEMORY 
UTILITY CONTROL STATEMENTS 



The load /dump central memory utility control statements allow the user to transfer 
information that resides in his job field length to a peripheral device or to transfer 
information from that device into central memory. The following statements are in- 
cluded in this category. 



DMP 


DMPECS 


PBC 


DMD 


LBC 


RBR 


DMDECS 


LOC 


WBR 



| NOTE [ 

For information concerning security restrictions 
associated with the use of these control state- 
ments, refer to Security Control in section 3. 

The DMP and DMD control statements dump central memory in octal representation 
and/or display code equivalences. Likewise, the DMDECS and DMPECS control state- 
ments dump ECS memory. These, statements are particularly helpful in creating dumps 
for debugging purposes. (Refer to Debugging Aids in section 12. ) Other transfers of 
2^£2? c ® ntral memory use the PBC statement which dumps a binary record to 
PUNCHB and the WBR statement which writes a binary record on a specified file. 

Data is loaded to central memory by the LBC, LOC, and RBR statements. The LBC 
control statement is useful in loading binary data in an unknown format. All numeric 
parameters may be expressed in octal (postradix is B) or decimal (postradix is D) no- 
tation. If no radix is specified, octal is assumed. 



DMP STATEMENT 

words M e'r C i° ntr01 Statement re< ? uests a dum P °" file OUTPUT of central memory in four 
The control statement format is: 

DMP (fwa, lwa) 
or 

or 
DMP. 

fwa First word address of memory to be dumped; fwa is relative to RA . 

If fwa is absent, dump mode depends on the presence or absence of 

lSith m^ 1S m grea iff than the USer ' S field len ^ h ' fwa is set at the field 
length minus 10 g . If fwa is greater than or equal to 400000 fi , the first 

S^Lt i SS *I fWa ? mUS 400000 8. memory from the first 8 dump address 



through lwa is dumped, and the job is aborted. 
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lwa Last word address plus 1 of memory to be dumped; lwa is relative to 

RA. If lwa alone is present, DMP assumes fwa equals 0. If neither 
fwa nor lwa is present, DMP dumps the exchange package and 40s 
locations before and after the program address register in the exchange 
package. If lwa is greater than the user's field length, the dump stops 
at the end of the field length. 

If either fwa or lwa is nonnumeric, DMP dumps the exchange package and 40g locations 
before and after the program address register in the exchange package. If both fwa and' 
lwa are greater than the user's field length, the last 10g words of the user's field length 
are dumped. If fwa equals lwa, the 108 words beginning at fwa are dumped. If fwa is 
greater than lwa, DMP issues an error message and terminates the job step. 

The user must not place another control statement (other than DMP, DMD, DMPECS, 
DMDECS, or EXIT) between the program to be dumped and the DMP statement. 

DMP suppresses duplicate lines and then issues the following output message. 

DUPLICATED LINES. 

In time-sharing jobs, DMP is effective only within procedure files. A dump from a 
terminal is formatted for 72-column output and written on local file ZZZDUMP. DMP 
displays an informative message at the terminal. 

DMD STATEMENT 

The DMD control statement requests a dump similar to that of the DMP statement but 
adds the display code equivalences to the right of the octal representations. 

The control statement format is: 

DMD(fwa,lwa) 

or 
DMD(lwa) 

or 
DMD. 

fwa First word address of memory to be dumped; fwa is relative to RA. 

If fwa is absent, dump mode depends on the presence or absence of lwa. 

lwa Last word address plus 1 of memory to be dumped; lwa is relative to 

RA. If lwa alone is present, DMD assumes fwa is 0. If neither fwa 
nor lwa is present, DMD dumps the exchange package and 40g locations 
before and after the program address in the exchange package. 

The DMD statement can be used from a time-sharing terminal only in a procedure file 
and only after OUTPUT is assigned to mass storage, as in the following example. 

.PROC.PROCA. 

ASSIGN(MS, OUTPUT) 

FTN(I=PROG) 

LGO. 

EXIT. 

DMD(0, 100) 

ROUTE(OUTPUT) 
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DMPECS STATEMENT 

The DMPECS control statement dumps the contents of an ECS field length on file OUTPUT | 
or a user-specified file. The dump is four words per line. If lines are duplicated, they 
are suppressed and the following notation is issued to the output file. 

DUPLICATED LINES. 

A DMPECS statement within a time- sharing job copies the contents of the ECS field length I 
to the local file ZZZDUMP and displays a message at the terminal informing the user of I 

the dump. ~ | 

The control statement formats are: 

DMPECS(fwa, Iwa) 
DMPECS (lwa) 
DMPECS(fwa, lwa, f , lfn) 

fwa First word address of ECS memory to be dumped; fwa is relative to the 

reference address of the field in ECS being used by the job (RAE). 

lwa Last word of ECS memory to be dumped; lwa is relative to RAE. 

f Print format (included for compatibility with NOS/BE). | 

lfn File to dump to. 

If the first format is used, the field in ECS memory defined by fwa and lwa is dumped to 
the file OUTPUT. Display code equivalences do not appear. 

If the second format is used, DMPECS assumes fwa is 0. Display code equivalences do 
not appear. 

If the third format is used, the specified field in ECS is dumped to lfn. The parameter f is 
ignored. Display code equivalences appear to the right of the octal representations, the 
same as the DMDECS control statement. 

The DMPECS statement must immediately follow a program to be dumped, except that an- 
other DMDECS or DMPECS, DMP, DMD, or EXIT may intervene. 

Dumping always stops at the field length in ECS (FLE) if lwa is greater than FLE. If either 
fwa or lwa is nonnumeric, the following error message is issued to the user's dayfile. 

ARGUMENT ERROR. 

If fwa is greater than FLE, fwa is set to FLE-10. If both fwa and lwa are greater than 
FLE, fwa is set to FLE-10 and lwa is set to FLE. If fwa is greater than lwa, the system 
issues the following message to the user's dayfile. 

FWA . GE. LWA4 1. 

If neither fwa nor lwa is specified, the following message is issued to the user's dayfile. 
ILLEGAL REQUEST. 

If no ECS field length exists for the user, the following message is issued to the user's 
dayfile . 

NO ECS. - 
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DMDECS STATEMENT 

The DMDECS control statement requests a dump of ECS memory on file OUTPUT. The 
dump is four words per line with display code equivalences to the right of the octal repre- 
sentations. If lines are duplicated, they are suppressed, and the following notation is 
issued to the output file. 

DUPLICATED LINES. 

The control statement formats are: 

DMDECS (fwa, lwa) 
DMDECS (Twa) 

fwa First word address of ECS memory to be dumped; fwa is relative to the 

reference address of the field in ECS being used by the job (RAE). If 
fwa is absent, DMDECS assumes fwa is 0. 

lwa Last word address of ECS memory to be dumped; lwa is relative to RAE. 

The DMDECS statement must immediately follow a program to be dumped, except that an- 
other DMDECS or a DMPECS, DMP, DMD, or EXIT may intervene. 

Dumping always stops at the field length in ECS (FLE) if lwa is greater than FLE. If 
either fwa or lwa is nonnumeric, the following error message is issued to the user's 
dayfile. 

ARGUMENT ERROR. 

If fwa is greater than FLE, fwa is set to FLE-10. If both fwa and lwa are greater than 
FLE, fwa is set to FLE-10 and lwa is set to FLE. If fwa is greater than lwa, the system 
issues the following message to the user's dayfile. 

FWA .GE. LWA+1. 

If neither fwa nor lwa is specified, the following message is issued to the user's dayfile. 
ILLEGAL REQUEST. 

If no ECS field length exists for the user, the following message is issued to the user's 
dayfile. 

NO ECS. 

The DMDECS statement can be used from a time-sharing terminal only in a procedure file 
and only after OUTPUT is assigned to mass storage, as in the following example. 

.PROCPROCB. 

ASSIGN(MS, OUTPUT) 

FTN(I=PROG) 

LGO. 

EXIT. 

DMDECS(0, 100) 

ROUTE(OUTPUT) 

LBC STATEMENT 

The LBC control statement is intended for loading binary data of unknown format. 

The control statement format is: 
LBC(addr) 

addr Address relative to RA at which binary load begins; if addr is omitted, 
(RA) is assumed. 
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LBC reads only one record from file INPUT. The user must make an LBC call for each 
record of data to be loaded. If addr is specified in the program call, binary data is loaded 
beginning at that address; otherwise, loading begins at the reference address (RA). 

LOC STATEMENT 

The LOC control statement reads octal line images from file INPUT and enters them in 
the user's CM field length. 

The control statement format is: 

LOC(fwa.lwa) 

or 
LOC (lwa) 

or 
LOC. 

fwa First word address of an area to clear (zero) before loading correction 

statements. If fwa is absent, LOC assumes 0. 

lwa Last word address plus 1 of the area to be cleared. If lwa is absent, 

LOC assumes 0. 

To process the LOC statement, the system reads correction statement images from the 
current INPUT record. A correction statement consists of an octal address and a data 
field. The address field specifies the location to be corrected, and the data field contains 
the data to be placed in that location. Both fields may start at any column as long as the 
address precedes the data. The address field consists of a one- to six-digit address. If 
it is 5 characters or less, it is separated from the data field by a nonoctal character (for 
example, a blank). If it is 6 characters, no separator is required. 

The data field consists of 1 to 20 octal characters. If it is less than 20 characters, it is 
terminated by a nonblank, nonoctal character and is stored right-justified. If it is 20 
characters, no terminator is required. Embedded blanks in the data field are ignored. 

If both fwa and lwa are specified and both are nonzero, storage is cleared from fwa to lwa, 
and the octal line images are loaded at the specified addresses. If the current INPUT 
record is empty, LOC clears the indicated area of memory. 

PBC STATEMENT 

The PBC routine writes one record from the specified area of CM to file PUNCHB. 
The control statement format is: 

PBC (fwa, lwa) 

or 
PBC (lwa) 

or 
PBC. 

fwa Address relative to RA at which the binary deck begins; if this parameter 

is omitted, the PBC operation depends upon the presence or absence of 
lwa. 

lwa Last word address plus 1 of the binary deck. If lwa alone is present, 

PBC assumes that fwa is RA. If lwa is fwa, and a nonzero value is 
specified, PBC adds lOg to lwa. If fwa and lwa is or are omitted, 
RA contains lwa in the lower 18 bits. If the upper 12 bits of RA are 
7700g, lwa is the lower 18 bits of the location following the prefix (77) 
table plus the length of the prefix table. 

CM is not altered by PBC. 
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RBR STATEMENT 

The RBR routine loads one binary record from a specified file. 
The control statement format is: 

R BR (n, name) 

n n is used in constructing the name of the file containing the binary recor.d 

to be read. If n is less than 4 characters and is numeric, TAPEn is 
the file name. If n contains a nonnumeric character or is 4 or more - 
characters long, n itself is used as the file name. If n is absent, TAPE 
is the file name. 

name A 1- to 7- character name used in a record prefix. 

The RBR routine loads one binary record from the specified file into central memory 
starting at RA. If the name parameter is included, a record prefix is placed in central 
memory starting at RA. The record itself follows. The following is the format of the 
record prefix. 



RA 
RA+1 
RA+2 
RA+3 

RA+1 7 
RA+20 8 

length Record length including the prefix 

length j Record length minus words RA through RA + 17g 

If the record is too long for available memory, memory is filled, excess data is skipped, 
and the following message is issued to the user's dayfile. 

RECORD TOO LONG. 

WBR STATEMENT 

The WBR routine writes a binary record from CM to a file at its current position. 
The control statement format is: 





59 


53 


47 


35 


17 




C 


) 




77 


00 


0016 





length 






name 









date (yy/mm/dd. ) 













' 








> 



















5200 





length i 





WBR(n.rl) 



rl 



n is used in constructing the name of the file on which the binary record 
is to be written. If n is less than 4 characters and is numeric, TAPEh 
is the file name. If n contains a nonnumeric character or is 4 or more 
characters long, n itself is used as the file name. If n is absent, TAPE 
is the file name. 

Record length in words. If rl is or absent, the length is taken from the 
lower 18 bits of RA. 



WBR begins writing from RA. 
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TAPE MANAGEMENT TO 



This section describes control statements used with magnetic tape files, t For additional 
information on NOS magnetic tape files, consult the glossary for definitions of terms; 
Magnetic Tape Files in section 2 for descriptions of tape labels and data formats; and 
appendix G for tape label formats. Section 6 describes the RESOUEC statement required 
in jobs that use more than one tape or removable auxiliary pack concurrently. 



NOTE 



The term file as used in this section may refer to 
a multifile file. Refer to table 1-2-1 for the EOR 
and EOF marks for tape files. 

The control statements described in this section are: 

ASSIGN Assigns a local file to a tape unitt (system origin jobs or jobs with system 

origin privileges only). Section 7 describes the ASSIGN statement for 
nontape files. 

BLANK Blank labels a tape and may restrict access to the labeled tape. 

LABEL Assigns a local file to a magnetic tape,T creates and verifies tape labels, 

and creates and accesses multifile set tapes. 

LISTLB Lists tape labels. 

REQUEST Assigns a local file to a magnetic tape device, t 

VSN Associates a file name with one or more VSNs for later assignment by a 

LABEL or REQUEST statement. 

TAPE ASSIGNMENT 

Whenever a tape is mounted, the system checks for labels. If the tape is labeled, the 
system records the volume serial number (VSN) read from the VOL1 label and the equip- 
ment on which the tape is mounted. When a tape assignment is requested by a LABEL or 
REQUEST statement specifying an lfn and a VSN (or an lfn that has been named in a previous 
VSN statement), the system compares the VSN with the VSNs read from mounted tapes. 
If a match is found, the system automatically assigns the tape to the requesting job, provided 
a deadlock would not occur, ft If the tape is not mounted, the system rolls out the job until 
a tape with the requested VSN is mounted. 



t If the user does not specify a VSN parameter or an MT or NT parameter on the tape 
assignment statement, the operator can assign any device to the file. 

tt Refer to the RESOURC statement in section 6. 
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For a mounted, unlabeled tape, the operator enters a command specifying the requested 
VSN. The system can then assign the tape. A VSN which contains nonalphanumeric char- 
acters should not be specified in a request for an unlabeled tape because nonalphanumeric 
characters cannot be entered with the operator command. 

If a VSN is not associated with the requested Ifn, the system directs the operator to assign 
an available device. 

CONTROL STATEMENT RULES 

On the tape assignment control statements (LABEL,. REQUEST, and ASSIGN), the user can 
specify the tape label contents, tape density, track type, 9-track conversion mode, data 
format, noise size, and processing options. If any of these specifications are omitted, the 
system uses a default value. 



| NOTE | 

For 9-track tapes, the density specification given 
on the tape assignment is used only when the tape 
is written from load point. Otherwise, the tape 
is read or written using the density previously 
used for that tape. To ensure that a labeled tape 
is at load point for rewriting the tape at a new 
density, perform one of the following before the 
write operation. 

• Rewind the tape. 

• Specify the W parameter on the LABEL state- 
ment used to assign the tape. 

• Assign the tape using a REQUEST or 
ASSIGN control statement. 

Specification of duplicate or equivalent parameters is not allowed on tape assignment con- 
trol statements. 



NOTE 



The user is advised not to create labeled S or L 
format tapes with tape marks embedded in the 
data. Future adherence to ANSI standards will 
make these tapes nonstandard as the ANSI standard 
allows tape marks to be used only as delimiters 
of label groups . 

The system allows use of a continuation line for an ASSIGN, BLANK, LABEL, REQUEST, 
and VSN control statement when any one of these requires more than 80 characters. If, in 
processing one of these statements, the system does not encounter a termination character 
prior to the end of the line, it assumes the next line is a continuation line. A continuation 
line should be terminated with a valid terminator. The terminator for a continuation line 
must appear in or before column 80. 
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note! 

The system accepts continuation lines from a 
time-sharing terminal only if they are within a 
procedure file. 

The programmer can use literals for parameters that contain nonalphanumeric characters. 
These parameters are FI/L, FA, SI/M, VA, FA, OFA, andVSN. Nonalphanumeric char- 
acters are characters other than letters, numbers, and asterisks. 

A literal is a character string delimited by dollar signs. Blanks within literals are re- 
tained. If the literal is to contain a dollar sign, two consecutive dollar signs must be 
included. Thus, the literal 

$A B$$41$ 
is interpreted as: 

A B$41 
When continuation lines are used, a literal cannot extend from one line to another. 

PROCESSING OPTIONS 

The PO= parameter on the LABEL, ASSIGN, and REQUEST tape assignment statements 
allows the user to specify one or more processing options that are to apply to that tape file. 
The characters representing the processing options and their meanings are listed below. 
PO=S gives the default end-of-tape conditions. Default error recovery attempts to recover 
blocks having errors by repeatedly rereading the block. 

p^ Meaning 

A Job is automatically aborted on an irrecoverable read or write parity 

error (refer to the N option) . 

E Error inhibit. All hardware read/write errors are ignored and process- 

ing continues. The system does not attempt error recovery, issue error 
messages, or return error status. During a read operation, blocks less 
than noise size (refer to the NS parameter) are unconditionally bypassed. 
This option is not intended for the normal user. It can be used to recover 
portions of data from a bad tape, to check out hardware, and to write on 
tape without skipping bad spots; in the latter case, the user is responsible 
for verifying that the data is written correctly. 

F Force unload. Unload at end of usage. (Refer to the U option. ) 

G Disables all hardware error correction activity in GE (6250 cpi) write 

mode. An on-the-fly error while writing a GE tape results in standard 
error recovery processing. The system erases the defective portion of 
tape, thereby reducing the amount of data that can be stored on the tape. 
The default is installation- defined (refer to the H option). 

H Enables hardware error correction activity in GE (6250 cpi) write mode. 

The system allows certain types of single-track errors to be written 
that can be corrected when the tape is read (on-the-fly correction). This 
is the recommended mode because it provides efficient throughput, error 
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M 



N 



Meaning 

recovery, and tape usage when writing GE tapes on a medium that is 
suitable for use at 3200 fci or 6250 cpi. The default option (G or H) is 
installation-defined. 

If, during a write operation, the system senses the end-of-tape (EOT), 
it rewrites the block on which the EOT occurred as the first block on 
the next volume. During a read operation, the block on which the EOT 
occurred is ignored and reading continues on the next volume. If a tape 
mark and the EOT are sensed at the same time, the EOT is ignored. 
This option cannot be specified for I or SI format tapes. Refer to the 
P and S options. 

Issues only the first and last error messages for each bad tape block. 
Numerous attempts are made to read each bad block, but only the 
messages for the first and last attempts are issued to the dayfile. The 

Issues an error message for each attempt to read a bad tape block. The 
default is installation- defined (refer to the L option). 

Job is not automatically aborted on an irrecoverable read or write parity 
error (refer to the A option); data is passed to the job on a read opera- 
tion. 

P If, during a write operation, the system senses the end-of-tape, the 

system writes a trailer sequence following the block on which the EOT 
was sensed. Any data that occurs following the block on which EOT was 
sensed, yet before the tape mark, is ignored. During a read operation, 
the system transfers the block on which the EOT was sensed to the user 
job. The read operation resumes on the next reel. If a tape mark and 
the EOT are sensed at the same time, the EOT is ignored. Eefer to 
the I and S options. 

R Enforce ring out. If the tape is mounted with the write ring in, job 

processing is suspended until the operator remounts the tape correctly. 

S Specifies where the system is to stop on an exit condition. For unlabeled 

tape, it directs the system to stop at the first tape mark after the EOT 
is sensed. For labeled tape, it directs the system to stop at the tape 
mark plus EOF1 or the tape mark plus EOV1 when the EOT is encountered. 

If, during a write operation, the system senses the end-of-tape, the 
system writes a trailer sequence following the block on which the EOT 
was sensed. This trailer sequence consists of a tape mark followed by 
an EOV1 label for labeled tapes and four tape marks for unlabeled tapes. 
The next block is written on the next volume. During a read operation, 
the EOT is noted and the system transfers to the user job the block on ' 
which the EOT was sensed plus all following blocks until a trailer se- 
quence (as described previously) is recognized. Reading resumes on 
the next volume. 
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p^ Meaning 

U Inhibit unload. Do not unload at the end of usage. For system origin 

jobs, the inhibit unload option is selected by default; for all other jobs, 
omission of the U option causes the tape to be unloaded at end of usage. 

W Enforce ring in. If the tape is mounted without the write ring in, job 

processing is suspended until the operator remounts the tape correctly. 

If both ring enforcement options (R and W) are specified or more than one EOT option 

(I, P, or S) is specified, the system issues a dayfile message and terminates the job step. 

For further information on end-of-tape/end-of-reel conditions, refer to the CLOSER, 
REWIND, and UNLOAD macros in section 3 and the LABEL macro in section 4 of volume 
2. 

ASSIGN STATEMENT 

The ASSIGN control statement names a tape unit and the local file to be assigned to that 
unit. It can create an unlabeled tape file or access an existing labeled or unlabeled tape. 
It cannot create or verify tape labels. 



NOTE 



Only system origin jobs or users validated for sys- 
tem origin privileges (DEBUG mode) and for use of 
magnetic tapes can use the ASSIGN statement to assign 
a tape unit. 

Jobs that use this statement without proper validation are aborted, and a dayfile message 
is issued. 

Before performing the assignment, the system unloads the local file (refer to the UNLOAD 
statement in section 7). 

The following description applies only to magnetic tape files; for use of the ASSIGN state- 
ment with devices other than magnetic tape, refer to section 7. , 

The control statement format is: 

ASSIGN(nn,lfn,VSN=vsn, j M ^ ) , ( D ^ n ) , F=format, LB=i, | F £ ^Jjj t ) , CV=conv, 

NS=ns,PO= Pl p 2 ...p n , (°|}> 

Required parameters: 

nn Device or device type to which the file lfn is assigned, nn can be the 

EST ordinalt of a magnetic tape unit or one of the device types MT or 
NT. Specifying MT informs the operator to assign the file to a 7-track 
magnetic tape drive; NT informs the operator to assign the file to a 
9-track magnetic tape drive. Omission of this parameter results in an 
error. 



t Contact installation personnel for a list of EST ordinals. 
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lfn 



Name of the file to be assigned to the device nn. 
eter results in an error. 



Omission of this param- 



Optional parameters: 



VSN=vsn 



MT 
or 

NT 

D=den 
or 

den 



F=format 



LB=i 



FC=f count 

or 

C=ccount 



A 1- to 6-character volume serial number that uniquely identifies a reel 
of tape. ASSIGN does not use the VSN parameter to assign the tape. 
The nn parameter determines the tape assignment. 



Specifies 7-track (MT) or 9-track (NT) tape drive, 
with the nn specification. 



It must not conflict 



Tape density; it must not conflict with the MT or NT specification. 
Installation-defined default. Ignored for 9-track tapes not positioned 
at load point. May be one of the following: 

7-track (MT) 9-track (NT) 

den Density den Density 



LO 

HI 

HY 

200 

556 

800 



200 bpi 
556 bpi 
800 bpi 
200 bpi 
556 bpi 
800 bpi 



HD 

PE 

GE 

800 

1600 

6250 



800 cpi 
1600 cpi 
6250 cpi 

800 cpi 
1600 cpi 
6250 cpi 



Data format. Default is I. Refer to Magnetic Tape Files in section 2 
for descriptions of the data formats. 

I Internal 

SI System internalt 

S Stranger 

L Long block stranger 

F Foreign 



Labeled or unlabeled tape. 
VSN is specified. 



Default is KU if VSN is omitted or KL if 



KU Unlabeled. 

KL ANSI-labeled. If the tape is a NOS tape, volume and header 

label access restrictions are enforced (refer to appendix G). 
NS Nonstandard-labeled. Assumes data begins immediately after 

the first tape mark. 

Whenever F format is specified, this parameter specifies maximum 
block size in frames (fcount) or in 6-bit characters (ccount). Ignored 
for other tape formats. No default value. 



t NOS /BE system default tape format (binary mode only); used for tape interchange with 
NOS /BE systems. 
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CV=conv 



NS=ns 



CK 

or 
CB 



Conversion model for 9- track tapes; applies to both labels and data 
on coded tapes; applies only to labels on binary tapes. Installation- 
defined default. Ignored for unlabeled I or SI format binary tapes 
whose trailer labels are always ASCII. Must not be specified with 
MT or 7-track density specification. 

AS ASCII /display code conversion. 

US Same as AS. 

EB EBCDIC /display code conversion. 

Noise size. Ignored for I and SI format tapes. Default is 18 frames 
for other formats. Maximum value is 31 frames. If NS=0 is specified, 
the default is used. 



PO=P]P2. • -Pn -^ string of characters (not separated by commas) that specify process- 
ing options (refer to Processing Options in this section). 



Ifn is to be used as a checkpoint file (refer to section 11). 

CK Each dump is written at the previous EOI of lfn. 
CB Each dump is written at the BOI of lfn. 



Example: 

ASSIGN(51,TAPE1,D=PE,F=SI) 

This statement assigns the file TAPE1 to the 9-track magnetic tape unit identified by EST 
ordinal 51. 

BLANK STATEMENT 

The BLANK control statement writes the ANSI standard labels VOL1, HDR1, and EOF1 
following the load point of a tape. The labels are written as follows (asterisks represent 
tape marks): 





VOL1 


HDR1 


* 


* 


EOF1 


* 


* 







If the value of a labeled field is specified by a BLANK statement parameter, that value is 
written; otherwise, the default value is used. Refer to appendix G for the tape label formats 
and default values. 



NOTE 



A BLANK statement issued in a nonsystem origin 
job cannot overwrite a label containing an unexpired 
expiration date or a nonblank VA field. 

If the FA field within the label is nonblank, a non- 
system origin job must specify the FA character 
using the OFA parameter. If the FA character is 
A , only the owner or a system origin job can over- 
write the label . 



t Refer to Magnetic Tape Users in appendix A. 
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The control statement format is: 

BLANK (VSN=vsn, (JfJ") , (^en* 1 ) .CV=conv,FA=fa,OFA=ofa,VA=va, 
OWNER =usernum/familyname, LSL=lsl,U) 

VSN=vsn 1- to 6-character volume serial number that uniquely identifies 

the reel of tape. It is entered in the VOL1 label. It need not 
match the VSN previously recorded on the tape. 

MT Specifies 7-track (MT) or 9-track (NT) tape drive. Installation- 

or defined default. Must not conflict with D=den specification. 

NT 

D=den Tape density; it must not "conflict with the MT or NT specification. 

or Installation- defined default. May be one of the following: 

den 

7-track (MT) 9-track (NT) 

LO 200 bpi HD 800 cpi 

HI 556 bpi PE 1600 cpi 

HY 800 bpi GE 6250 cpi 

200 200 bpi 800 800 cpi 

556 556 bpi 1600 1600 cpi 

800 800 bpi 6250 6250 cpi 

CV=conv Conversion modef for 9-track tape labels. Installation- defined 

default. Must not be specified with MT or 7-track density speci- 
fication. 

AS ASCII/display code conversion. 

US Same as AS. 

EB EBCDIC /display code conversion. 

FA=fa File accessibility character indicating who has access to the labeled 

tape. Value entered in HDR1 and EOF1 labels. 

Blank Unlimited access (default). 

A Only the owner of this NOS written tape can access 

it. 

Other In all future accesses of this tape, the user must 
specify this character. 

OFA=ofa Old file accessibility character on a labeled tape that is to be 

relabeled. This parameter must be specified if the FA field is 
currently other than A or blank. Future accesses of the tape 
must specify the character specified with the FA parameter. 

VA=va Volume accessibility character indicating that the valume must 

be accessed as an ANSI-labeled tape (LB=KL). If VA is nonblank, 
only a system origin job can change VOL1. Default is unrestricted 
access. Refer to the VOL1 format in appendix G. 



tRefer to Magnetic Tape Users in appendix A. 
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OWNER = Owner identification entered in VOL1 label. Determines the 

usernum/ owner for file accessibility (FA) parameter. 

familyname 

LSL=lsl Label standard level entered in VOL1 label. Default is 1. 

1 Tape labels and data format for this volume con- 

form to the ANSI standard. 

Blank Tape labels and data format for this volume may- 

or may not conform to the ANSI standard. 

U If U is specified, the tape is physically unloaded when returned 

after blank labeling. If U is omitted, physical unloading is 
inhibited. This parameter does not apply to system origin jobs. 

An installation can use the BLANK statement to restrict use of its labeled tapes. Once a 
tape has been blank labeled, the user can modify the labels as follows: 

1. If the volume accessibility field of VOL1 indicates unlimited access (that is, VA 
is blank), the user can: 

• Include another BLANK statement to change VOL1, HDR1, or EOF1 values. 

• Request the tape as unlabeled (with the parameter LB=KU) and write it in 
whatever format the user specifies. 

• Include a LABEL statement to change HDR1 by specifying one or more of the 
parameters associated with that label and specifying the W parameter. 

2. If the volume accessibility field is nonblank, the user can: 

« Include a LABEL statement to change HDR1. However, in requesting a tape 
in which VA is nonblank, the user must specify an ANSI labeled tape (with the 
parameter LB=KL), and therefore, cannot change or destroy the VOL1 label. 

• If validated, submit a system origin job to change VOL1. 

LABEL STATEMENT 

Like the ASSIGN and REQUEST statements, the LABEL control statement associates a file 
name Ifn with a magnetic tape, usually identified by its VSN. Unlike the ASSIGN and 
REQUEST statements, the LABEL statement can create and verify tape labels. It can 
also position a multifile set for access to any of its existing files or for appending a new 
file. The LABEL statement can create and access unlabeled as well as labeled tapes. 



NOTE 



A LABEL statement cannot overwrite a label with 
an unexpired expiration date (refer to appendix G). 

To write the labels that begin a labeled tape (refer to Magnetic Tape Files in section 2), 
the user should specify a write label (W) parameter. The W parameter always rewinds 
the tape to load point and rewrites the first label group. The label contents remain the 
same when a LABEL statement with the W parameter names an lfn already assigned to a 
tape file. 
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If the tape was not previously part of a multifile set (the SI field in the first HDR1 label 
is blank), then specification of the SI and QN=9999 parameters rewrites the initial tape 
labels. 

To position the tape after any HDR1 label other than the first HDR1 label (multifile set 
only), the SI parameter must be specified. When SI is specified, the R and W parameters 
are ignored unless QN=1 and the first file on the tape is to be written. The system deter- 
mines where to position the tape by matching the SI, FI, and QN parameter values (if 
specified) to the corresponding values in the HDR1 label. (The HDR1 label format is given 
in appendix G). 

To write the EOF1 and HDR1 labels between two files in a multifile set (refer to figure 
1-2-2), the user specifies the SI and QN=9999 parameters. The W parameter is ignored 
if specified when appending a file (QN=9999). 

If neither the MT nor NT parameter is specified and no VSN is named, the operator can 
assign the file to any equipment. The user must be validated for the assigned equipment 
or the job is terminated. 

The control statement format is: 



LA BELOfn, VSN =vsn, 
PO=p 1 p 2 ...p n . 
FA=fa,G=genno, E "=gvn, j *!^). 



|^),D=den.F=format,LB=i, ( P £2£5) .CV=conv,NS=ns, 
ICKI ISI=setid j |SN=secno) JQN=seqnol IFI=fileid 1 
ICBJ ' I M=setidl ' \ V=secno J * 1 P=seqnol 

RT=yyddd \ 
T=ddd I 



I P =seqno ! 



L=fileidj ' 



Required parameter: 
lfn 



Name of the file that resides or is to reside on magnetic tape. If 
lfn is already assigned to a mass storage file, processing continues 
with the next control statement. To assign a previously assigned 
lfn, the user must return lfn before its reassignment. If lfn is 
already assigned to a tape and the R parameter is specified, the 
contents of the tape labels are compared to the statement parameter 
specifications. If the label verification fails, the job aborts. 



Optional parameters: 



VSN =vsn 



MT 
or 

NT 



A 1- to 6-character volume serial number that uniquely identifies 
a reel of tape. If VSN is omitted, the operator assigns an available 
unit to lfn. Multiple VSNs can be specified if separated by / or = 
characters. If the VSNs are separated by the = character, LABEL 
assigns lfn to the first available VSN in the list. If the VSNs are 
separated by the / character, lfn is a multivolume file set, and 
LABEL assigns the volumes in the sequence given. 

Requests 7-track (MT) or 9-track (NT) tape drive. Installation- 
defined default. Must not conflict with D=den specification. 



D=den 



Tape density; must not conflict with MT or NT specification. 
Installation- defined default. Ignored for 9-track tape not positioned 
at load point. Can be one of the following. 
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7 -track (MT). 



9 -track (NT) 



den Density den Density 



F=format 



LB=i 



FC=f count 

or 

C =ccount 

CV=conv 



NS=ns 



PO=P!P2...Pn 



LO 

HI 

HY 

200 

556 

800 



200 bpi 
556 bpi 
800 bpi 
200 bpi 
556 bpi 
800 bpi 



HD 

PE 

GE 

800 

1600 

6250 



800 cpi 
1600 cpi 
6250 cpi 

800 cpi 
1600 cpi 
6250 cpi 



Data format. Default is I. Refer to Magnetic Tape Piles in section 2. 

I Internal 

SI System internalt 

S Stranger 

L Long block stranger 

P Foreign 

Labeled or unlabeled tape. Default is KL. 

KL ANSI-labeled. 
KU Unlabeled. 

NS Nonstandard-labeled. Assumes data begins immediately 
after the first tape mark. 

Whenever F format is specified, this parameter must specify the 
maximum block size in frames (no default value). Ignored for other 
tape formats. 

Conversion modett for 9-track tapes; applies to both labels and data 
on coded tapes; applies only to labels on binary tapes. Installation- 
defined default. Ignored for unlabeled I or SI format binary tapes 
whose trailer labels are always ASCII. Must not be specified with 
MT or 7-track density specification. 

AS A SCII /display code conversion. 

US Same as AS. 

EB EBCDIC /display code conversion. 

Noise size; any block containing fewer than ns frames is considered 
noise and discarded. Ignored for I and SI format tapes. Default 
is 18 frames for other formats. Maximum value is 31 frames. If 
NS=0 is specified, the default is used. 

A string of characters (not separated by commas) that specifies 
processing options. Refer to Processing Options in this section. 



tNOS/BE system default tape format (binary mode only); used for tape interchange with 
NOS/BE systems. 

t tRefer to Magnetic Tape Users in appendix A. 
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CK 

or 
CB 



lfn is to be used as a checkpoint file (refer to section 11). 

CK Each dump Is written at the previous EOI of lfn. 
CB Each dump is written at the BOI of lfn. 



Optional tape label parameters (refer to appendix G): 



SI=setid 



1- to 6-character file set identifier; must be specified for file 
positioning within a multifile set. The default is blank. 



| NOTE 



SN =secno 



QN=seqno 



FI=fileid 

or 

L=fileid 

FA=fa 



G=genno 

E=gvn 

CR=cdate 



RT=yyddd 

or 

T=ddd 



To conform to the ANSI standard for tape inter- 
change when creating a multifile set, the user 
must specify the same setid for all files within 
the set. 

One-to four-digit file section number specifying the position of the 
volume within a multivolume file set (numbered consecutively from 
0001). The default is 1. 

One-to four-digit file sequence number specifying the position of the 
file within the multifile set (numbered consecutively from 0001). The 
default is 1. QN must be set to 9999 to append a new file to a multi- 
file set. 

1- to 17- character file identifier recorded in the HDR1 label (refer 
to appendix G). The default is blank. 



File accessibility character indicating who has access to the labeled 
tape. 

Blank Unlimited access (default). 

A Only the owner of the tape can access it. 

Other To access the tape, the user must specify the char- 

acter in the FA field of the HDR1 label. 

One-to four-digit generation number. The default is 1. 

One-to two-digit generation version number. The default is 0. 

Creation date in the form yyddd where l<ddd^366. Used only on 
read operations; write operations always use the current date. 

Used to determine the expiration date entered in the HDR1 label. 
On or after this date the label and the file can be overwritten. 
R=yyddd specifies the expiration date where yy is the last two digits 
of the year, and ddd is the day of the year (lgddd<366). T=ddd 
specifies the number of days the file is to be retained (l<ddd^999). 
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R If R is specified, the system compares the values recorded on the 

or file labels with the LABEL statement parameter values. If the com - 

W parison fails, it terminates the job. R is the default. 

If W is specified, the system writes ANSI standard labels containing 
the values specified with the LABEL statement parameters or their 
default values. If the tape is mounted without the write ring, job 
processing is suspended until the operator remounts the tape correctly. 
If both the W and the PO=R parameters are specified, the job step 
aborts . 

W and R are ignored when SI is specified and QN>1. When QN=1 
(default value) and W are specified, the initial header is rewritten.. 

Example 1: 

LABEL(NEWFILE,VSN=TP01,FI=FILEA,W) 

This statement creates an ANSI-labeled tape which the job can access by the file name 
NEWFILE. Default values are used for all fields of HDR1 except the file identification, 
FILEA. Any data written is recorded in the default I format. 

Example 2: 

LABEL(OLDFILE,VSN=TP01,FI=FILEA) 

This statement assigns the tape file created in a previous job (refer to example 1) to the 
file name OLDFILE. The system compares the VSN in the VOL1 label and the file identi- 
fication in the HDR1 label with the values on the statement. 

Example 3'- 

The following sequence of control statements in a single job creates two files of a multifile 
set. 

LABEL(TAPE, VSN ONE, D=PE,'F=I, FI=FIRSTFILE, SI=TEST,-QN=1, W) 

COPYBRONPUT, TAPE) 

LABEL(TAPE, FI=SECONDFILE, SI=TEST, QN=9999) 

COPYBRONPUT, TAPE, 10) 

RETURN (TAPE) 

The first statement writes the initial labels on the tape for the first file in the file set. The 
second label statement specifies QN=9999 to add a second label group. Future references 
to the second file of the file set must specify QN=2 (refer to examples 6, 7, and 8). 

Example 4: 

The following control statements in another job add the third label group and file to the file 
set created in example 3. 

LABEL(TAPE, VSN ONE, D=PE, F=I, FI=THIRDFILE, SI=TEST, QN=9999) 

COPYBR(DISK, TAPE, 3) 

RETURN(TAPE) 
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Example 5 

Any one of the following control statements can be used to read the first file of the file set 
created in examples 3 and 4. 

LABEL(TAPE, VSN ONE, D=PE, F=I) 
LABEL(TAPE, VSN=ONE, D=PE, F=I, FI=FIRSTFILE) 
LABEL(TAPE, VSN ONE, D=PE, F=I, FI=FIRSTFILE, SI=TEST) 

The last two statements position the tape according to the file identifier specified. 
This method is used if the sequential location of the file on the tape is not known. 

LABEL(TAPE, VSN ONE, D=PE, F=I, QN=1, SI=TEST) 

This statement positions the tape according to the sequence number of the file. 

LABEL(TAPE, VSN=ONE, D=PE,F=I,QN=1,FI=FLRSTFILE,SI=TEST) 

This statement positions the tape according to the sequence number sDecified- 
but the file identifier specified must also be correct or the job aborts'. 

Example 6 

Any one of the following control statements can be used to read the second file of the multi- 
file set created in example 3. 

LABEL(TAPE, VSN ONE, D=PE, F=I, QN=2,SI=TEST) 
LABEUTAPE, VSNONE, D=PE, F=I,FI=SECONDFILE, SI=TEST) 
LABEL(TAPE,VSNONE,D=PE,F=I,FI=SECONDFILE,QN=2,SI=TEST) 

Example 7 

The following control statements destroy the third file of the multifile set created in 
example 3. 

LABEL(TAPE, VSNONE, D=PE,F=I,QN=2, SI =TEST) 

COPYBR(DISK, TAPE) 

REWIND(TAPE) 

The tape is positioned at the beginning of file 2, a new me 2 is written, and the tape is 
rewound, thereby writing a trailer sequence after file 2. 

Example 8 

The following example replaces the second file of the multifile set created in example 3 
and retains the first and third files. F 

LA BEUTAPE, VSN =ONE,D=PE,F=I,QN=3,SI=TEST) 
COPYBR(TAPE, DISK, 3) 

LABEUTAPE, VSN=ONE, D=PE,F=I,QN=2,SI=TEST) 
COPYBR(INPUT, TAPE) 

LABEL(TAPE,VSN=ONE,D=PE,F=I,QN=9999.SI=TEST,FI=THIRDFILE) 
REWZND(DISK) 

COPYBR(DISK, TAPE, 3) 

The first copy saves file 3, the second copy replaces file 2, and the third copy copies 
back file 3. The third LABEL statement rebuilds the labels for file 3. 
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LISTLB STATEMENT 

The LISTLB control statement lists the labels of an ANSI-labeled tape file previously 
assigned the file name lfn. 

The control statement format is: 

LISTLBOfn. (™| . 1*3321 • I-O'ltype. L=out» 

lfn File name assigned to tape file whose labels are to be listed. 

SI=setid 1- to 6-character file set identifier. If specified, only label groups 

or whose HDR1 label contains this value are listed. 

M=setid 

QN=seqno One-to four-digit file sequence number. If seqno is specified, only 
the label group whose HDR1 label contains this value is listed. If 
seqno is specified, SI must be specified; otherwise, LISTLB ter- 
minates. 

LO=ltype Label type(s) to be listed. The default is R. Required and optional 
labels are listed in appendix G. Combinations of ltype mnemonics 
can be specified, such as LO=VH to list only the VOLn and HDRn 
labels. 

A List all labels. 

R List required labels. 

O List optional labels. 

V List VOLn labels. 

H List HDRn labels. 

F List EQFn labels. 

E List EOVn labels. 

U List UVLn, UHLn, and UTLn labels. 

L=out File on which the labels are to be listed. Default is OUTPUT. 

To list labels for a multifile set (lfn contains more than one HDR1/EOF1 label pair), the 
tape must be positioned at load point. LISTLB then positions the tape for reading the 
requested labels. It searches for labels through all volumes associated with lfn. At the 
end of the multifile set or if an expected label group is not found, the following dayfile 
message is issued, n is the sequence number of the last file found, (nnn should be ignored. ) 

MULTI-FILE NOT FOUND, lfn AT nnn. 
REQUEST SECTION n+1. 
FOUND SECTION n. 

After issuing this dayfile message, LISTLB leaves the tape positioned after the last listed 
label. The next statement processed for the tape file must be either RETURN, EVICT, 
UNLOAD, or LABEL. 
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Example V 

The following statements list the second label group of file set ABCDEF. 

LABEL(T,VSN=EXAMP1,MT,D=HY,SI=ABCDEF) 
LISTLB(T, SI=ABCDEF, QN=2) 

Example 2' 

To list only the volume and header labels (trailer labels omitted) of a multivolume file 
set, the user must request a volume of the file set, list its labels, and return the file set, 
repeating the procedure for each volume of the file set. 

LABEL(T,VSN=REEL1,MT,D=HY) 
LISTLB(T, LO=VH) 
RETURN (T) 

LABEL(T,MT,D=HY,VSN=REEL2) 
LISTLB(T,LO=VH) 

Example 3: 

To list all labels of the following file set, only one LISTLB control statement is required. 

VSN(T=REEL1 /REEL2) 
LABEUT, VSN=REEL1. D=HY) 
LISTLB(T) 

The LISTLB(T) statement lists all labels on the volumes associated with T, that is, REEL1 
and REEL2. 

REQUEST STATEMENT 

The REQUEST control statement associates a file name, lfn, with a magnetic tape device, t 
usually described in a comment following the statement terminator. This comment is 
displayed at the system console, directing the operator to make the requested assignment. 
However, if the tape is labeled and the user previously specified a VSN via the VSN control 
statement or included the VSN parameter on the REQUEST statement, the system can 
automatically assign the tape. 

[ NOTE | 

Users should avoid issuing the REQUEST state- 
ment because it prevents use of a control point 
while the operator responds to the tape request. 
The LABEL statement is recommended for tape 
assignment. 



tlf the user does not specify a VSN parameter or an MT or NT parameter on the statement, 
the operator can assign any device to the file. If the user is not validated for the assigned 
device, the job aborts. 
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The REQUEST statement can create unlabeled tape files and access existing labeled and 
unlabeled tape files. It cannot create or verify tape labels. 

The control statement format is: 

REQUESTOR VSN=vsn, {*£). [ D £™\ ,F=format,LB=i, j ^J^S I .CV-eomr. 

(CK 1 
CBl } 

Required parameter: 

Ifn Name of the file that resides or is to reside on magnetic tape. If 

lfn is already assigned to a mass storage file, processing continues 
with the next control statement. To assign a previously assigned 
lfn, the user must return lfn before its reassignment. 

Optional parameters: 

VSN=vsn 1- to 6 -character volume serial number uniquely identifying a reel 

of tape. The user should specify a VSN for labeled and unlabeled 
tapes. If VSN is omitted, the operator must assign an available 
device to lfn. 

MT Requests 7-track (MT) or 9-track (NT) tape drive. Installation- 

or defined default. Must not conflict with D=den specification. 

NT 

D=den Tape density; must not conflict with MT or NT specification. 

or Installation- defined default. Ignored for 9-track tape not positioned 

den at load point. May be one of the following. 

7-track (MT) 9-track (NT) 

den Density den Density 

LO 200 bpi HD 800 cpi 

■HI 556 bpi PE 1600 cpi 

HY 800 bpi GE 6250 cpi 

200 200 bpi 800 800 cpi 

556 556 bpi 1600 1600 cpi 

800 800 bpi 6250 6250 cpi 

F=format Data format. The default is I. Refer to Magnetic Tape Files in 

section 2 for format descriptions. 

I Internal 

SI System internalt 

S Stranger 

L Long block stranger 

F Foreign 

LB=i Labeled or unlabeled tape. The default is KL if a volume serial 

number is specified by the VSN parameter or by a VSN control 
statement; otherwise, the default is KU. 

f NOS/BE system default tape format (binary mode only); used for interchange with NOS/BE 
systems. 
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FC =f count 

or 

C =ccount 

CV=conv 



NS=ns 



PO=p 1 p 2 ...p n 



CK 

or 

CB 



KL ANSI-labeled. 
KU Unlabeled. 

NS Nonstandard labeled. Assumes that data begins immediately 
after the first tape mark. 

Whenever F format is specified, this parameter must specify the 
maximum block size in frames (no default value). Ignored for other 
tape formats. 

Conversion modet for 9-track tapes; applies to both labels and data 
on coded tapes; applies only to labels on binary tapes. Installation- 
defined default. Ignored for unlabeled I or SI format binary tapes 
whose trailer labels are always ASCII. Must not be specified with 
MT or 7-track density specification. 

AS ASCII/display code conversion. 

US Same as AS. 

EB EBCDIC /display code conversion. 

Noise size. Ignored for I and SI format tapes. Default is 18 frames 
for other formats. Maximum value is 31 frames. If NS=0 is speci- 
fied, the default is used. 

A string of characters (not separated by commas) specifying process- 
ing options (refer to Processing Options in this section). 

lfn is to be used as a checkpoint file (refer to section 11). 

CK Each dump is written at the previous EOI of lfn. 
CB Each dump is written at the BOI of lfn. 



Example: 



Imln end f messa i e to th « operator requesting that volume XYZ be mounted on tape unit 
NT62 and assigned to lfn TAPE1, the user could issue the following statement. 

REQUEST, TAPE1. NEED VSN=XYZ ON NT62. 

VSN STATEMENT 

The VSN control statement associates a file name lfn with one or more volumes of tape 1 1 
f n ^i™ association allows the system to assign the specified VSN to lfn without reference 
to a VSN parameter on the LABEL or REQUEST statement or to an operator command. 
Once declared, an lfn/VSN association remains until the file is returned. 

The control statement format is: 

VSN (lfn! =vsn! , lfn 2 =vsn 2 , . . . , lfn^vsn^ 



f Refer to Magnetic Tape Users in appendix A. 
TtUp to 55 VSNs can be specified for a single file name in any combination of duplicate reel 
and /or multireel specifications. 
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Ifn- File name to be associated with vsiij. 

vsni One or more 1- to 6-character volume serial numbers to be asso- 

ciated with If nj. If vsni contains nonalphanumeric characters, it 
must be a literal [delimited by dollar signs ($)]. 

vsnj Meaning 

omitted An available scratch tape is automati- 

cally assigned to lfn^. 

Same as omitted. 

SCRATCH Same as omitted. 

vsn-]=vsn2=. . . =vsn Names duplicate volumes, any of which 

may be used with Ifn^. 

vsnj/vs^/. . . /vsn n Successive volumes to be assigned to 

lfnj. t The system assigns volumes 
in the order listed. 

With a VSN statement the user can: 

• Omit the VSN keyword from his LABEL or REQUEST statements and specify 

lfn/ VSN associations on the VSN statement instead. This allows the user to specify 
new VSNs without changing LABEL or REQUEST statements. 



• 



• 



Override the VSN specified on subsequent ASSIGN, LABEL, REQUEST, or VSN 
statements. For example, the sequence 

VSN (FILEA =123) 
VSN(FILEA =124) 
. LABEL(FILEA) 

directs the system to assign FILEA to the tape with VSN 123. However, if the 
user returns the file lfn, he can specify another lfn /VSN association. Thus, the 
following sequence directs the system to assign FILEA to the tape with VSN 124. 

VSN (FILEA =123) 
RETURN (FILEA) 
VSN (FILEA =124) 
LABEL(FILEA) 

Associate the VSNs of two or more duplicate volumes with one file name. For 
example, the following statement indicate that either the tape with VSN VOL 100 
or the tape with VSN VOL101 can be assigned to FILE1. 

VSN(FILE1=VOL100=VOL101) 



t All subsequent volumes must have the same characteristics as the first volume in the 
sequence. (Characteristics include labels, track type, density, and conversion mode.) 
It is recommended that all volumes be blank labeled (refer to the BLANK statement) 
before use in a multivolume sequence. 
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Specify the VSNs of a multivolume file set. For example, the following statement 
indicates that FILE2 may extend through the three volumes identified by VSN23, 
VSN24, and VSN25. 

VSN(FILE2=VSN23/VSN24/VSN25) 
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CHECKPOINT/RESTART 11 



A job may terminate as the result of system, operator, or programmer error. For 
some jobs, it beeomes more advantageous to accept the overhead of checkpoint pro- 
cedures than to run the risk of losing the entire job output. The checkpoint /restart 
feature is implemented through the CKP control statement and the RESTART control 
statement. 



| NOTE { 

For information concerning security restrictions 
associated with the use of these control statements, 
refer to Security Control in section 3. 



CKP STATEMENT 

The CKP control statement causes a checkpoint dump to be taken. 

The control statement format is: 

CKPOfnj, lfn 2 , . . . , lfn n ) 

lfn. Specifies a file to be included in the checkpoint dump. If no files 

are specified, all files local to the job at the time the CKP state- 
ment is processed are checkpointed. 

Each time- a CKP statement is processed, the system takes a checkpoint dump. The dump 
is written on the tape or mass storage checkpoint file specified on a REQUEST, ASSIGN, or 
LABEL control statement with the CK or CB parameter. The dump consists of a copy of 
the user's central memory, the system information used for job control, and the names and 
contents of all assigned files explicitly or implicitly identified by the CKP statement. These 
files are: 

• INPUT, OUTPUT, PUNCH, PUNCHB, P8, CCCCCCO, and LGO. These files 
are always included in the checkpoint dump. CCL ZZZZZxx working files are 
also included if present. 

• Common files, library type files, working copies of indirect access files, and 
some direct access files. If one of these types of files is specified on the 
CKf statement, it is included in the checkpoint dump, and all other files of 
that type are excluded. If no files are specified, all files of these types 
assigned to the job are included in the dump. 

Each checkpointed file is copied according to the last operation performed on it. If 
the last operation was a write, the file is copied from the BOI to its position at check- 
point time; only that portion is available at restart time. The file is positioned at the 
latter point. 
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If the last operation was a read and the EOI was not detected, the file is copied from 
its position at checkpoint time to the EOI; only that portion is available at restart 
time. The file is positioned at the former point. If the last operation was a read 
and the EOI was detected, no copy is performed. 

The exception to this rule is the type of operation performed on execute-only direct 
access files. If a dump is specified for this type of file, its name and associated 
system information are copied but the contents of the file itself is not copied. Thus, 
if the user attempts to resume from such a dump, RESTART is unable to retrieve ' 
that file and aborts. The user can avoid this by selecting the NA and FC options of 
the RESTART statement and retrieving the file himself. 

If the checkpoint file is to reside on mass storage, the user must include a SAVE or 
DEFINE control statement in the checkpoint job and a GET or ATTACH control state- 
ment in the restart job. 

If the checkpoint file is to reside on magnetic tape, care should be taken to use a 

— — „«,.„„.„.. »„ (,_. .»u uiuo.uicj.cu uxa.ua. tape tuuc wiucu ntis never oeen useaj 

cannot be specified as the checkpoint file since the checkpoint program attempts to 
read the tape to determine the number of the last checkpoint. The tape subsystem 
then aborts the job with a blank tape read message. 

The system numbers checkpoints starting at 1 and increments by 1 to a limit of 4095. 
At this point, a second cycle of numbering begins, again starting at 1. An example 
showing how to restart from a specific checkpoint is given in the RESTART control 
statement section. 

RESTART STATEMENT 

The RESTART control statement directs the system to restart a previously terminated 
job from a specified checkpoint. 

The control statement format is: 

RESTARTdfn, nnnn, x { ) 

lfn Identifies the checkpoint file; the user must have write permission 

to lfn. 

nnnn Number of the checkpoint from which to restart; if nnnn is *, the 

last available checkpoint on lfn is used; if nnnn is omitted, the 
first checkpoint is used. The nnnn parameter can be obtained 
from the CHECKPOINT nnnn COMPLETE messages issued to the 
user's dayfile in response to CKP control statements. 

x. Any of the following in any order: 

RI If this parameter is included, the control statement file 

on lfn is not restored. The control statement file of 
this restart job at its current position is used instead. 
If this parameter is not included, the entire control 
statement file of the checkpointed job is restored and 
set to its position at checkpoint time; any control state- 
ments following RESTART are not processed. 

NA If this parameter is included, RESTART does not abort if 
a required file is not available. Also, if NA is included 
and a read parity error occurs in an attempt to obtain 
a file from checkpoint nnnn, RESTART selects check- 
point nnnn-1 if it is available. 
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FC Normally RESTART restores all files included in the 

specified checkpoint. However, if this option is select- 
ed, RESTART first checks if a file is already local to 
the restart job. If it is, RESTART does not replace 
it with the file on the checkpoint dump. 

The user must assign lfn to his job before the RESTART statement is processed. He 
must include a REQUEST, ASSIGN, or LABEL control statement if lfn resides on mag- 
netic tape or a GET or ATTACH control statement if lfn resides on mass storage.- 

Checkpoint dumps are numbered in ascending order from 1 to 4095. When nnnn equals 
4095, the numbering sequence begins again at nnnn equal to 1; The value of nnnn de- 
pends on the structure of the checkpoint file, as defined by the CK and CB parameters 
of the REQUEST, ASSIGN, or LABEL control statements. 

If CK was specified when the checkpoints occurred, each dump is appended to the 
checkpoint file, and therefore, all dumps up to the time the job aborted are available 
for restart. The user may specify a particular checkpoint dump in the following man- 
ner. 

Assume a CK file of the name CHKFILE is being used and checkpoint number 4095 has 
been passed. The job is terminated at checkpoint number 10 in the second cycle of 
numbering. To restart the job from checkpoint 4 of the second numbering cycle, the 
following control statements can be used. 

SKIPR (CHKFILE, 8196) There are two records for every checkpoint, and 4098 

checkpoints must be skipped to reach checkpoint 4 of 
the second numbering cycle. 

COPYBR(CHKFILE,AA, 2) The fourth checkpoint is copied to file AA. At this 

point, file CHKFILE is not positioned correctly for 
subsequent checkpoints. If the user intends to continue 
checkpointing on this file, a 

BKSP, CHKFILE. 

statement should be included. 

RESTART(AA. . . ) The job is restarted from file AA using the fourth 

checkpoint. 

If the CB parameter was specified on the ASSIGN, LABEL, or REQUEST statement naming 
the checkpoint file, each dump is written over the preceding dump, and therefore, only the 
last dump is available. If two REQUEST, ASSIGN, or LABEL statements with CB specified 
are submitted, successive dumps are alternated between two files; therefore, the last two 
dumps are available, t 

If the CK parameter is specified for alternate files or if more than two checkpoint files are 
specified, the system issues a dayfile message and aborts the job. 



tlf alternate checkpoint files are used and a read parity error occurs in an attempt 
to read the last checkpoint, RESTART aborts even if the NA option was selected. 
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AU files copied by RESTART are made local to the restart job. Therefore, the user 
must make sure that any direct access files are not lost. For example, assume that 
direct access files X, Y, and Z are attached to a job. The job is then checkpointed 
and X, Y, and Z are copied to the checkpoint file lfn. To retain these files as direct 
access files during restart, the user should include the following sequence of control 
cards. 

PURGE(X.Y.Z)"* 

DEFINE(X, Y, Z) 

RESTARTUfn, nnnn, x t ) 

If the information table associated with a file was included on the checkpoint file, but 
the file itself was not copied, RESTART issues the appropriate commands to retrieve 
the file. 
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DEBUGGING AIDS 12 



Program errors include errors that prevent compilation or assembly of a source 
program and errors that prevent execution of an object program. A programmer 
determines the causes of compilation errors using the compiler diagnostics, a source 
listing, and the compiler reference manual. The cause of an execution error is 
often more difficult to determine. If the programmer cannot determine the cause of 
the error from the execution error message, he can use the CDC CYBER Interactive 
Debug Utility or interpret memory dumps to locate the cause. CYBER Interactive 
Debug is described in its reference manual (listed in the preface). This section 
describes central memory dumps and their use as a debugging aid. 

A programmer can dump the job exchange package and locations within the job field 
length using control statements described in section 9. The exchange package shows 
the program location where execution ended and the contents of the CPU registers at 
that time. 

A programmer interprets a memory dump using the variable locations given in the. 
program load map and the display code equivalences given in appendix A. 

CENTRAL MEMORY DUMPS 

The first line of a dump gives the boundaries of the memory that is dumped, relative 
to the user's field length. Four central memory words are printed per line, with the 
address of the leftmost word printed on the left-hand side of the page. When the phrase 
DUPLICATED LINES appears within the dump, all groups of four words not printed are 
exactly like the last group of four words. Each word is divided into four groups of 
15jo bits, with the octal representation printed. Figure 1-12-10 is an example of a cen- 
tral memory dump. 

EXCHANGE PACKAGE DUMPS 

The user can dump his exchange package using a DMP or DMD statement (refer to 
section 9). Figures 1-12-1 and 1-12-2 show actual exchange package dumps. The 
format of the first dump is produced by a CYBER 170 Model 171, 172, 173, 174, 
175, 720, 730, 750, or 760; a CYBER 70, Model 71, 72, 73, or 74; or a CDC 6000 
Series Computer System. The second dump format is produced only by the CYBER 
170 Model 176 Computer System. 
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EXCHANGE PACKAGE. 



p 


242 


AO 51760 


BO 





(AO) 


0000 


0000 


0000 


0000 


0000 


RA 


622400 


A1 1 


B1 


1 


(A1) 


0516 


0420 


0000 


0000 


0000 


FL 


52000 


A2 114 


B2 


30 


(A2) 


0400 


0005 


0300 


0007 


7775 


EM 


7007 


A3 574 


B3 


6 


(A3) 


5555 


5555 


5555 


5555 


5555 


RAE 





A4 557 


B4 


22 


(A4) 


7777 


7777 


7777 


7777 


7776 


FLE 





A5 573 


B5 


1 


(A5) 


1717 


0631 


4631 


4631 


4632 


HA 


3600 


A6 1 


B6 7776 


(A6) 


0516 


0420 


0000 


0000 


0000 






A7 277 


B7 14657 


(A7) 


3232 


3232 


3206 


0300 


0171 


XO 


7777 7777 7777 0000 


0000 
















X1 


0000 0000 0000 0000 


0000 
















X2 


0000 0000 0000 0000 


0000 
















X3 


0000 0000 0040 0000 


0000 
















X4 


2000 0000 0000 0000 


0012 
















X5 


1717 0631 4631 4631 


4632 
















X6 


0516 0420 0000 0000 


0000 
















X7 


0000 0000 0000 0000 


0000 
















(RA) 


0000 0000 0000 0000 


0000 
















(RA+1) 


0516 0420 0000 0000 


0000 

















Figure 1-12-1. Exchange Package Dump 
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p 


10435 


AO 2165 


BO 





(AO) 


1725 


2420 


2524 


0000 


0131 


RA 


136100 


A1 


1 


B1 


1 


(A1) 


0516 


0420 


0000 


0000 


0000 


FL 


15000 


A2 6251 


B2 777755 


(A2) 


1717 


0631 


4631 


4640 


3615 


PSD 


70000 


A3 


2 


B3 6032 


(A3) 


0000 


0000 


0000 


0000 


0000 


RAE 





A4 6207 


B4 11437 


(A4) 


0400 


0062 


4600 


0000 


0000 


FLE 





A5 4324 


B5 12711 


(A5) 


2000 


0000 


0000 


0000 


0065 


MA 


1200 


A6 


1 


B6 776677 


(A6) 


0516 


0420 


0000 


0000 


0000 


EEA 


1200 


A7 12557 


B7 


30 


(A7) 


6000 


0000 


0000 


0001 


5000 


XO 


0000 0000 0000 


0000 


0000 
















X1 


0000 0000 0000 


0000 


0000 
















X2 


1717 0631 4631 


4640 


3615 
















X3 


2000 0000 0000 


0000 


0012 
















X4 


2000 0000 0000 


0000 


0000 
















X5 


0000 0000 0000 


0000 


0000 
















X6 


0516 0420 0000 


0000 


0000 
















X7 


2000 0000 0000 


0000 


0001 
















(RA) 


0000 0000 0000 


0000 


0000 
















(RA+1) 


0516 0420 0000 


0000 


0000 
















Figure 1-12-2. Ej 
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The following are the exchange package fields and their contents. 

Label Contents 

P Program address at which execution stopped. 

RA Reference address; starting address of central memory field 

length. 

FL Field length in central memory. 

EMt Exit mode. Each bit set indicates that if this hardware- detected 

error occurs, the program aborts. The bit positions are num- 
bered with as the rightmost bit. 

Bit 
Position Error 

11 CM data error, tf eration parity error. 1 1 

10 Central memory control (CMC) input error, ft 

9 ECS flag register operation parity error, ft 

5-8 Not used. 

3-4 Hardware error exit status bits.ttt 

2 Indefinite operand. 

1 ' Operand out of range. 

Address out of range. 

The EM field in figure 1-12-1 has bit positions 11, 10, 9, 2, 
1, and set. 

PSDtttt Program status designator (PSD) register. Each bit set indicates 

the setting of a mode flag or an error condition. The bit posi- 
tions are numbered with as the rightmost bit. 



Bit 




Positions 


Error 


17 


Exit mode. 


16 


Monitor mode. 


15 


Step mode. 


14 


Indefinite mode. 


13 


Overflow mode. 


12 


Underflow mode. 



tDoes not apply to CYBER 170 model 176. 
tt Applies to CYBER 170 models 171, 172, 173, 174, 175, 720, 730, 750, and 
760 only. 
1"ft Applies to CYBER 70 model 74 only, 
tt ft Applies to CYBER 170 model 176 only. 
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Label Contents 

Bit 
Position Error Conditions 

11 LCME error, 

10 CM error. 

9 LCME block range error. 

8 CM block range error. 

7 LCME direct range error. 

6 CM direct range error. 

5 Program range error. 

4 Not used. 

3 Step condition. 

2 Indefinite condition. 

1 Overflow condition. 

Underflow condition. 

The PSD field in figure 1-12-2 has bit positions 14, 13, and 12 set. 

RAE ECS reference address; starting address of ECS field length. 

FLE ECS field length. 

MA Monitor address (normal exit address for the CYBEB 170 model 

176). 

EEA Error exit address (CYBER 170 model 176). 

Ai Contents of the address registers. 

(Ai) Contents of the central memory word addressed by the named 

address register. 

Bi Contents of the increment registers. 

Xi Contents of the operand registers. 

(RA) Contents of the reference address word. 

(RA+1) Contents of the request word following the reference address 

word. 

GENERATING MEANINGFUL DUMPS 

The following methods are used to generate meaningful central memory dumps. 
• Error Exit Control 

By using the EREXIT macro within his COMPASS program, the user can direct 
execution when certain errors occur, rather than having his program completely 
halt execution. This enables him to use it as a checkpoint method (that is, to 
save generated data to this point). It could also enable him to do further cal- 
culations or to write pertinent data to an output file. Refer to section 6, 
volume 2 for a description of this macro. 
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• EXIT/NOEXIT/ONEXIT Control 

Once program execution ceases, due to an error condition, and control state- 
ment processing is resumed, the user can direct which statements are to be 
processed through the use of the EXIT, NOEXIT , and ONEXIT statements. 
Upon an error condition, the user can issue the DMP control statement to 
obtain appropriate dumps. For a detailed description of these control state- 
ments, refer to section 6. 

• Dumps may also be generated under control of the user's program through the 
use of the SYSTEM macro. The FORTRAN user can generate dumps by calling 
the DUMP subroutine. 

READING CM DUMPS 

Figures 1-12-3 through 1-12-11 are output from a FORTRAN program source deck 1 

processed by the following sequence of control statements. I 

DREW. 

USER(EFD252,D) 

CHARGE(599,PASS3) 

SETCORE.O. 

MAP (ON) 

FTN,EL=F. 

LGO. 

OVL. 

DMP. 

DMP, 4500. 

The source deck in the example consists of four parts. 

• Main program (main overlay) 

• Function subprogram 

• Subroutine subprogram 

• Primary overlay 



such 
I 



Each part is listed separately followed by the corresponding address assignments, sue! 
as variable assignments, program length, and common blocks (refer to figure 1-12-3). 

Figures 1-12-7 and 1-12-8 illustrate the load map generated by the MAP control state- | 
ments. The load map gives the address and references of all entry points. Maps are 
listed separately for each overlay. Output generated by the program follows the load 
map (refer to figure 1-12-9). | 

Figures 1-12-10 and 1-12-11 illustrate central memory dumps generated by the DMP. | 
and DMP, 1000. control statements, respectively. 

The following examples illustrate the use of these dumps to obtain specific information. 
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Example 1: (Finding Data Locations in_ a Core Dump) 

Referring to figure 1-12-3, the variable I is used as the control variable in the DO 
loop defined by statements 16 through 20. To find the value of I at job termination, 
the following steps must be performed. 

1. Find I in the variable assignments (lower half of figure 1-12-3), noting that I 
is at relative address 4217s. 

2. Find the first word address (FWA) of the main overlay TESTA. (Refer to the 
load map, figure 1-12-7.) The FWA of TESTA is 153g. 

3. Add (153g + 4217 g = 4372 g ) to obtain the absolute address of I. 

4. In figure 1-12-11, address 4372 contains 0013„ (H in ). This is the last 
value of I. s 10 

Example 2: (Finding Data Locations in a Core Dump) 

To find the variable B(3), the following points must be considered. 

• Find B in the variable assignments (lower half of figure 1-12-3). The value is 
12, which means that B begins at relative location 12s of common block AAA. 
By referring to the map (figure 1-12-7), note that AAA begins at absolute 
address Ills. Therefore, Ills + 12s (relative location of B) equals 113g, 

the beginning address of array B. B(l) is 123a, and the address of B(3) is 
125 8 . 

• The location in core of the B array is illustrated in figure 1-12-11. 

Example 3: (Finding an Address Within the Program) 

Referring to figure 1-12-10, note that the program stopped at address 10004 (the value 
of P). To find where this is in the program, the following points must be considered. 

• Figure 1-12-7 or 1-12-8 contains the routine addresses. 

• Figure 1-12-7 illustrates that routine CPUSYS is at address 10001. This 
means the program ended in routine CPUSYS. 
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OVERLAY(OVL,0,0> 

PROGRAM TESTA C I RPUT, OUTPUT) 

C0HK0N//EO00) 

COMMON/AAA/A(10),B(10>,C(3,3> 

COMMON/BLOCKA/BLKC5 ) 

DIMENSION N(50) 

DATA UU),I'1.10)/1.,2. ,3.,«.,5.,6.,7.,8.,9-, 

DAT* (BCI),I«1,5)/1O0. ,200. ,300. ,100. ,500./ 

DATA (B(I),I=6,10)/600.,700. ,800. ,900., 1000./ 

DATA CC1,1>,C(1,2),CC1,3)/101.,202.,303./ 

DATA C(2,n,C(2,2),CC2,3)/2.1,2-2,2.3/ 

DATA CC3. D,C(3, 2), CC3,3)/3. 1,3.2,3.3/ 

DATA (K(J),J=1,50)/50«123/ 

CALL 0VERLAY(4HOVLA,l,0) 

CALL PSNTC BLOCKA) 

DO 30 I si, 10 

A(I>=A(I)»AU) 

AU)=TRY<A(I),AU)) 
30 B(I)=TRI(AU>,AU)> 

DXl 35 J=l,5 
35 BLK(J) = ACJ)*A(2»J> 

CALL OVERLAY C4HOVLA,1,0) 

CALL PR NT (BLOCKA) 

CC1,1)*J 

END 



SYMBOLIC REFERENCE KAP (R=1> 



ENTRY POINTS 
4137 TESTA 
















VARIABLES SN 

A 

BU 

24 C 

1217 I 

4221 N 


TYPE 
REAL 
REAL 
REAL 
INTEGER 
INTEGER 


RELOCATION 
ARRAY AAA 
ARRAY BLOCKA 
ARRAY AAA 

ARRAY 




12 

4216 



4220 


B 
BLOCKA 

E 
J 


REAL 
REAL 
REAL 
INTEGER 


FILE NAMES 
INPUT 


MODE 


2054 


OUTPUT 










EXTERNALS 

OVERLAY 
TRI 


TYPE 
REAL 


ARCS 
3 

2 








PRNT 
TRY 


REAL 


STATEMENT LABELS 
30 









35 








LOOPS LABEL 
4145 30 • 
4164 35 


INDEX 

I 
J 


FROM -TO 
16 19 
20 21 


LENGTH 
14B 

4B 


PROPERTIES 

EXT REFS 
INSTACK 





ARRAY 



COMMON BLOCKS LENGTH 

/ / 100 

AAA 29 

BLOCKA 5 



STATISTICS 

PROGRAM LENGTH 
BUFFER LENGTH 
CM LABELED COMMON LENGTH 
CM BUNK COMMON LENGTH 
52000B CM USED 



301B 


193 


4006B 


2054 


426 


34 


144B 


100 



Figure 1-12-3. Main Program of Main Overlay (0, 0) 
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1 

5 


FUNCTION TRY(A.B) 
10 TRY » SQRTCA)*SQRT(B) 

RETURN 

ENTRY TRI 

IF (A.LE.B) 10,20 
20 TRY = SQRTCA)-SQRT(B) 

RETURN 

END 


SYMBOLIC 1 


1EFEREXCE HAP (Rxl ) 


ENTRT POINTS 
U TRI 


« TRY 


VARIABLES SN 
A 
3» TRY 


TYPE RELOCATION 
REAL F.P. 
REAL 


EXTERNALS 

SORT 


TYPE ARGS 
REAL 1 LIBRARY 


STATEMENT LABELS 
7 10 




STATISTICS 

PROGIAM LENGTH 
52000B 


358 29 
CH USED 



Figure 1-12-4. Function Subroutine of Main Overlay (0, 0) 



SUBROUTINE PRNT(A) 

C0NHON//S(100) 

C0HMON/AAA/PC29) 

CCMH0N/A/3UB(5) 

BiO 

DO 50 1.1,29 
50 B»B*P<I) 

PRINT 55, B, (SUB(I),I.1,5) 
55 FORMAT <1I,6F17.7> 

RETURN 

END 



SYMBOLIC REFERENCE HAP (Rs1> 



ENTRT POINTS 
3 PRNT 








VARIABLES 
A 
D 
P 


SN TYPE 
REAL 
REAL 
REAL 


RELOCATION 
•UNUSED F.P. 
ARRAY / / 
ARRAY AAA 


26 1 

27 : 
! 


FILE NAHES 

OUTPUT 


MODE 
FMT 






STATEMENT LABELS 
50 


24 


55 FM' 


LOOPS LABEL 
11 50 


INDEI 

I 


FROH-TO LENGTH 
6 7 3B 


PROPERTIES 
INSTACE 


COMMON BLOCKS 
/ / 
AAA 

A 


LENGTH 
100 
29 

5 







REAL 

INTEGER 
REAL 



STATISTICS 

PROGRAM LENGTH 308 2« 

CM LABELED COMMON LENGTH «2B 3* 
CM BLANK COMMON LENGTH HUB 100 
52000B CM USED 



Figure 1-12-5. Subroutine of Main Overlay (0,0) 



1-12-8 



60435400 J 



OVERLAY(OVLA,1,0) 
PROGRAM OVLIO 
COMMON/AAA/K(29) 
PRINT 105, (WU), 1=1, 7) 
PRINT 105,(KCI),I=8,1«) 
PRIST 105, (W(I>, 1*15, 21) 
PRIKT 105, (WU), 1=22, 28) 
PRINT 106,CWC29i) 

105 FORMAT(1X,7F17.7) 

106 F0RMATC«X,F17.7) 
END 



SYMBOLIC REFERENCE HAP (R=1) 

ENTRY POINTS 
5 OVLIO 

VARIABLES SN TYPE RELOCATION 

51 I INTEGER 

FILE NAMES HOSE 
OUTPUT FMT 

STATEMENT LABELS 

15 105 FHT «7 106 

COMMON BLOCKS LENGTH 
AAA 29 

STATISTICS 

PROGRAM LENGTH 52B 12 

CH LABELED COMMON LENGTH 35B 29 
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8.0000000 

500.0000000 
2. 1000000 
3. 3000000 


0. 0000000 
2.0000000 
9.0000000 
600.0000000 
3. 1000000 


0.0000000 

3.0000000 

10.0000000 
700.0000000 
202. 0000000 


0.0000000 

1.0000000 

100.0000000 

800.0000000 

2. 2000000 


0.0000000 

5.0000000 

200.0000000 

900.0000000 

3.2000000 


0.0000000 
6. 0000000 

300.0000000 

1000.0000000 

303.0000000 


7. 0000000 
400. 0000000 
101.0000000 

2. 3000000 


6177.2000000 
2. 0000000 
16.0000000 
6.3215553 
2. 1000000 
3.3000000 


0.0000000 
4.0000000 
18.0000000 
6.9282032 
3.10O0O00 


0.0000000 

6.0000000 

20.0000000 

7.1833H8 
202.0000000 


0. 0000000 
8.0000000 

2.8284271 
8.0000000 
2.2000000 


0. 0000000 
10.0000000 
4.0000000 
8.1852814 
3.2000000 


0. 0000000 

12.0000000 

4.8989795 

8.9442719 

303.0000000 


14.0000000 

5.6568542 

101.0000000 

2. 3000000 


795.7198875 


0.0000000 


0.0000000 


0.0000000 


0.0000000 


0.0000000 





Figure 1-12-9. Program Output 
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EXCHANGE PACKAGE. 



p 


10001 A0 2227 BO 





(AO) 


1725 ; 


2KZ0 2524 0000 


0131 












RA 


712100 A1 


1 B1 


1 


(A1) 


0516 


0420 0000 0000 


0000 












FL 


15100 A2 6111 B2 


777755 


CA2) 


1717 


0631 4631 4610 


3615 












EM 


7007 A3 15020 B3 


6235 


CA3) 


6000 


0000 0131 5700 


0000 












RAE 


10000 A4 6102 B4 


11460 


(AD 


0400 


0061 1100 0000 


0000 












FLE 


7000 AS 1711 B5 


13157 


(A5) 


2000 


0000 0000 0001 


1201 












HA 


4000 A6 


1 B6 


2000 


(A6) 


0516 


0420 0000 0000 


0000 














A7 14217 B7 


30 


(A7) 


0000 i 


0000 0131 5701 


4726 












10 


0000 0000 


0000 


0000 0000 






















XI 


0000 0000 


OQOO 


0000 0000 






















X2 


1717 0631 


4631 


4640 3615 






















X3 


2000 0000 


0000 


0000 0012 






















X4 


2000 0000 


0000 


0000 0000 






















« 


0000 0000 


0000 


0000 0001 






















16 


0516 0420 


0000 


0000 0000 






















XT 


2000 0000 


0000 


0000 0001 






















(HA) 


0000 0000 


0000 


0000 0000 






















(RA*1 ) 


0516 0420 


0000 


0000 0000 






















CM DUMP 


FROM 7744 TO 


10044. 






















7744 


37423 


10711 


10100 


20236 


03070 


07743 


72677 


76314 


10044 


03340 07747 14044 


36007 


11606 


03260 


07752 


T75Q 


100T7 


12223 


13777 


43470 


61700 


07772 


0200 


07774 


71600 


07717 03340 07763 


12226 


20636 


12336 


46000 


7751 


10077 


72777 


77753 43470 


03370 


07756 


71000 


OO024 


61700 


07757 02000 07774 


46400 


07716 


61000 


46000 


7760 


63770 


10011 


07710 


07743 


71407 


77753 


37334 


20436 


37224 


02000 07754 46000 


20636 


12676 


36336 20636 


7764 


36226 


46000 


61000 


46000 


71600 


00024 


73070 


37776 


43470 


03370 07767 10066 


10600 


37330 


20636 


37226 


7770 


61700 


07771 


02000 


07774 


46400 


07716 


61000 


46000 


63770 


10011 07710 07743 


02000 


07765 


61000 


46000 


7771 


22610 


20003 


36606 


15064 


11146 


20032 


20451 


12040 


12620 


51600 07716 12630 


46400 


07716 


61000 


46000 


10000 


54660 


02770 


00000 


46000 


54110 


20123 


03310 


10003 


04000 


10014 00000 00000 


01300 


00000 


61000 


46000 


10001 


04000 


06126 


00000 


00000 


51100 


OOOOl 


03110 


10005 


54610 


04000 10003 46000 


51100 


10001 


10611 


46000 


10010 


51100 


00066 


03210 


10012 


51100 


10002 


10611 


46000 


51600 


10003 51100 00001 


10611 


01000 


10002 


46000 


10011 


20652 


01000 


10004 


46000 


51100 


00001 


03110 


10015 


00000 


00000 61000 46000 


51100 


00001 


03110 


10016 


10020 


71602 


20311 


01000 


10014 


71102 


20314 


27601 


20652 


12662 


01000 10004 46000 


00000 


00000 


61000 


46000 


10021 


53120 


20173 


03310 


1O023 


03010 


10023 


51100 


00001 


03010 


10021 04000 10024 


20151 


46000 


61000 


46000 


10030 


71601 


52307 


20652 


12661 


01000 


10004 


61000 


46000 


04000 


06124 00000 00000 


20630 


12161 


73610 


20123 


10031 


03210 


10027 


20151 


13116 


20636 51600 


10037 


74660 


12116 


04000 10030 46000 


00000 


06127 


00000 


00001 


10010 


04000 


11505 


00000 


00000 


61100 


00001 


01000 


11061 


71600 


11406 50607 77746 


51100 


10040 


20136 


10611 


10011 


50607 


77747 


10622 


43766 


50607 


77744 


21306 


15737 


21306 73630 50607 77741 


50707 


77740 73721 


16000 



Figure 1-12-10. Exchange Package Dump 
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FROM 


TO 


4500. 
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OOOOO 


OOOOO 


OOOOO 


05160 


42000 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 
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OOOOO 


OOOOO 


OOOOO 
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OOOOO 


OOOOO 


OOOOO 
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OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 




DUPLICATED LIHES. 




























54 


56110 


03110 


00051 


54710 


51100 


00001 


03110 


00055 


64550 


02550 


OOOOO 


46000 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


60 


15051 


52000 


OOOOO 


00061 


OOOOO 


13100 


OOOOO 


00001 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


64 


17261 


40000 
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40000 
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00007 
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40000 
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01000 


12746 


40000 
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17261 


45700 
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OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


74 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


100 


51000 


OOOOO 


01000 


00001 


01247 


10000 


OOOOO 


12746 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


104 


OOOOO 


OOOOO 


OOOOO 


13025 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


110 


24052 


32401 


OOOOO 


04312 


17214 


OOOOO 


OOOOO 


OOOOO 


TT224 


OOOOO 


OOOOO 


OOOOO 


17226 


OOOOO 


OOOOO 


OOOOO 


114 


17234 


OOOOO 


OOOOO 


OOOOO 


17235 
17244 


OOOOO 


OOOOO 


OOOOO 


17236 
17245 


OOOOO 


OOOOO 


OOOOO 


17237 
17215 


OOOOO 


onnno 


OOOOO 


120 


17244 


OOOOO 


OOOOO 


OOOOO 


40000 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


52023 63147 


74736 


124 


17224 


OOOOO 


OOOOO 


OOOOO 


17224 


71421 


60500 


44411 


17225 


52023 


63147 


74736 


17226 


24613 


01655 


51333 


130 


17226 


73317 


27205 


41145 


17227 


36735 20426 


40772 


17234 


OOOOO 


OOOOO 


OOOOO 


17234 


17416 


66315 


75547 


134 


17234 


36156 


74671 


37645 


17226 


OOOOO 


OOOOO 


OOOOO 


17214 


14631 


46314 


63146 


17216 


14631 


46314 


63146 


140 


17276 


24000 


OOOOO 
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17214 


31463 


14631 


46315 


17216 


31463 


14631 


46315 


17304 


57000 


OOOOO 
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144 


17214 
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63146 
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17216 
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63146 


31463 
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OOOOO 
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17236 
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17244 
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17246 
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OOOOO 


17247 
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11162 


02524 
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00001 
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OOOOO 


OOOOO 


OOOOO 


00224 


OOOOO 


OOOOO 


OOOOO 
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OOOOO 


OOOOO 
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OOOOO 


OOOOO 


OOOOO 
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OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


164 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


00600 


OOOOO 


OOOOO 


00022 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOQO 


OOOOO 


170 


14000 


OOOOO 


OOOOO 


OOOOO 
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OOOOO 
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00006 
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OOOOO 


06600 


OOOOO 


OOOOO 


OOOOO 
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OOOOO 


OOOOO 
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OOOOO 


OOOOO 
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OOOOO 
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OOOOO 
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OOOOO 
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OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


17252 


42025 
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2230 


04130 


46000 


00360 


02300 


OOOOO 


OOOOO 


OOOOO 


02300 


OOOOO 


OOOOO 


OOOOO 


02300 


63360 


OOOOO 


01000 


02302 


2234 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


02237 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


00001 


2240 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


OOOOO 


00004 


00600 


OOOOO 


OOOOO 


14T62 


03200 


OOOOO 


OOOOO 


22600 


OOOOO 


OOOOO 


2244 
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OOOOO 


OOOOO 


06120 
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2251 
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OOOOO 


OOOOO 


OOOOO 
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OOOOO 
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Figure 1-12-11. Central Memory Dump (Sheet 1 of 2) 
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1-12-15 



2260 00000 00000 00000 00000 

2261 00000 00000 00000 00000 
2270 00000 00000 00000 00000 

DUPLICATED LIKES. 
2300 55555 55555 55555 55531 
2304 55555 53657 33333 33333 
2310 33333 33333 33555 55555 
231" 00000 00000 00000 00000 

2320 33333 33333 55555 55555 

2321 55555 55555 35m 15751 

2330 33335 73333 33333 33333 

2331 55555 55541 33335 73333 
2340 33573 33333 33333 33355 
234« 33333 35555 55555 55534 
2350 57343 33333 33333 35555 
2354 33335 55555 55555 55555 
2360 55553 63336 57333 33333 
2364 55555 55555 55555 55555 
2370 57353 33333 33333 35555 
2374 33335 55555 55555 55555 
2400 55555 55533 57333 33333 
2404 55555 55555 55375 73333 
2410 43573 33333 33333 33355 
2414 33333 35555 55555 55555 
2420 57333 33333 33333 35555 
2424 33335 55555 55555 55555 
2430 55555 55537 57434 44344 
2434 55555 55555 55555 55541 
2440 55555 54257 37433 63634 
2444 43403 54334 37555 55555 
2450 00000 00000 00000 00000 
2454 33333 33333 55555 55555 
2460 55555 55555 55553 65735 
2464 55355 73633 33333 33333 
2470 33000 00000 00000 00000 
2*74 33333 33333 55555 55555 
2500 55555 55555 55553 35733 
2504 00000 00000 00000 00000 

DUPLICATED LINES. 

4300 00000 00000 00000 00000 

4304 00000 00000 00000 116 10 

4310 00000 00000 00000 00000 

«314 01000 07404 00160 01311 

4320 51500 04372 52450 00110 

4324 01000 04466 00220 04311 

4330 01000 04476 00230 04311 

4334 71700 00001 51700 04373 

4340 61550 00002 24700 46000 

4344 01000 07404 00260 04311 

4350 27005 24700 51700 00135 

4354 00000 00000 00000 04370 

4360 00000 00000 00000 00122 

4361 00000 noooo 00000 01367 
1370 00000 00000 00000 00000 

437a boooo 00000 00000 00173 

DUPLICATED LUES. 

4454 00000 00000 00000 00173 

4460 17261 40155 55555 55555 

4464 51400 04516 10644 46000 

4470 46000 46000 46000 46000 

'474 51500 04514 30056 24700 

45C0 51600 04170 04000 04467 



00000 00000 00000 00000 
01040 02300 00000 00000 
00000 .00000 00000 00000 



00000 10000 00000 00000 
00000 00000 00000 00226 

00000 00000 00000 00000 



00000 00000 00000 00000 

00000 00000 oooop 00000 

00000 00000 00000 00000 



57333 


33333 


33333 


35555 


55555 


55555 55355 73333 


33333 33333 


55555 


55555 


33335 


55555 


55555 


55555 


37573 


33333 33333 33355 


55555 55555 


55554 


05733 


55555 


55541 


57333 


33333 


33333 


35555 55555 55555 


55425 73333 


33333 


33333 


55555 


55555 


55555 


55543 


57333 


33333 33333 35555 


55555 55555 


55445 


73333 


55553 
33333 


43357 
33333 


33333 


33333 

ccccc 


Jill 5 . 


55555 55555 534 33 


33573 33333 


33333 


33355 










55553 


53333 57333 33333 


33333 «M5 


«}« 


55537 


OOOOO 


00000 


00000 


00000 


55555 


55555 55554 03333 


57333 33333 


33333 


35555 


33333 


33333 


55555 


55555 


55423 


33357 33333 33333 


33335 55555 


55555 


54333 


55555 


55555 


44333 


35733 


33333 


33333 33555 55555 


55343 33333 


57333 
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Figure 1-12-11. Central Memory Dump (Sheet 2 of 2) 
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SYSTEM UTILITY CONTROL STATEMENTS 13 



NOS provides the following utilities for file maintenance. 

EDIT Edits a text file. 

KRONREF Generates a cross-reference listing of system, symbols. 

MODIFY Edits a Modify-formatted program library file. 

OPLEDIT Removes modification decks and identifiers from a Modify-formatted 
program library file. 

PROFILE Enables a master user to update and inquire about a profile file. 

UPDATE Edits an Update-formatted program library file. 

UPMOD Converts an Update-formatted program library file to a Modify- 

formatted program library file. 

XEDIT Edits a text file. 

EDIT STATEMENT 

The EDIT control statement calls the Text Editor utility. The Text Editor enables a 
user to manipulate data on a specified mass storage file through use of special input 
directives called edit commands. For a detailed description of the Text Editor and 
an explanation of these commands, refer to the Text Editor Reference Manual. 

The control statement format is: 

EDITClfnj, m, lfn 2 , lfn 3 ) 

or 

EDIT(FN=lfn lf M=m, ^lfhg, L=lfn 3 ) 

lfnj Name of file to be edited (referred to as edit file). This specifi- 

cation is required for batch origin jobs. 

m Mode of file processing: 

ASCII or AS ASCn mode edit file. 

NORMAL or N NORMAL mode edit file. 

lftij File from which directives (edit commands) are to be read. 

If omitted, INPUT is assumed. 

lfn. File to which output is to be written. If omitted, OUTPUT is 

assumed. 
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KRONREF STATEMENT 

The KRONREF control statement generates a cross-reference listing of system symbols 
used by decks on a Modify .OPL. 

The control statement format is: 

KRONREF(P=lfn r L=lfn 2 , S=lfn 3 , G=lfn 4 ) 

P^nj OP L input from file lfni. If the P option is omitted or P alone 

is specified, file OPL is assumed. 

L=lfn 2 List output on file lfn2. If the L option is omitted or L alone 

is specified, file OUTPUT is assumed. 

S=lfn 3 System text from overlay lfn3. If the S option is omitted or 

S alone is specified, file NOSTEXT is assumed. 

G=lfn 4 System text from local file lfn4. If G is omitted, system text 

is acquired as specified or defaulted by the S option. If G 
alone is specified, local file TEXT is used. Use of the G 
option overrides any S specification. 

The names of programs on the OPL are listed for those decks that reference the 
following. 

PP direct cell locations defined in lfn„ or Ifn,. 

PP resident entry points defined in lfn,. 

Monitor functions. 

Central memory pointers (in low core) defined in lfn, or lfn.. 

Central memory locations (in low core) defined in lfn 3 or lfn 4 . 

Control point area words defined in lfn„ or lfn 4 . 

Dayfile message options. 

File types and mass storage constants. 

Job origin types, queue types, and priorities. 

Error flags referenced. 

Common deck, calls. 

PP packages called. 

Special entry points. 
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MODIFY STATEMENT 

The MODIFY control statement edits a Modify- formatted program library file. 
The control statement format is: 
MODIFY^, p 2 . • • • . P n ) 

p. Any of the following in any order: 

I Use directive input from file INPUT. If the 

I option is omitted, File INPUT is assumed. 

I^fn* Use directive input from file Iffaj. 

1=0 Use no directive input. 

p Use file OPL for the old program library. 

If the P option is omitted, file OPL is 
assumed. 

P=lfn5 Use file lfn g for the old program library. 

P=0 Use no old program library 

C Write compile output to file COMPILE. If 

the C option is omitted, file COMPILE is 
assumed. 

C=lfn3 Write compile output to file lfn 3 . 

C=0 Write no compile output. 

N Write new program library on file NPL. 

N=lfn 4 Write new program on file lfn 4 . 

N=0 Write no new program library. If this option 

is omitted, N=0 is assumed. 

S Write source output on file SOURCE. 

S=lfn 5 Write source output on file lfn 5 . 

S=0 Write no source output. If this option is 

omitted, S=0 is assumed. 

L List output on file OUTPUT. If the L option 

is omitted, file OUTPUT is assumed. 

L=lfn g List output on file lfng. 

L=0 List no output. 

LO Select list options: ECTMWDS 

LO=chars Select up to seven list options which can 
be any of the following. 

E Errors. 

C Directives other than INSERT, 

DELETE, RESTORE. 

T Input text. 

M Modifications made. 

W Compile file directives. 

D Deck status. 

S Statistics. 

I Inactive statements. 

A Active statements. 
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A Write compressed compile file. 

D Ignore errors. 

F Modify all decks. 

U Modify only decks mentioned on DECK 

directives; F overrides the U option. 

NR Do not rewind the compile file. 

X Rewind input and output files, set A option, 

and call the COMPASS assembler when 
modification is complete. 

X=prog Rewind input and output files, set A option, 

and call the processing program prog when 
modification is complete. 

X=0 Do not call another processing program. If 

this option is omitted, X=0 is assumed. 

Q Rewind the output file, set A option, and call 

the COMPASS assembler when modification 
is complete. 

Q=prog Rewind the output file, set A option, and 
call the prog assembler when modification 
is complete. 

Q=0 Do not call another processing program. If 

this option is omitted, Q=0 is assumed. 

Z if - this parameter is present, the MODIFY 

control card contains the input directives 
following the terminator. When this param- 
eter is specified, the I parameter is ignored. 



NOTE 



Do not place another terminator 
after the directives. 

CV=63 Convert 64-character set OPL to 63-char- 

acter set OPL. 

CV=64 Convert 63 -character set OPL to 64-char- 

acter set OPL. 
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The following parameters are effective only if the X or Q 
option is selected. \ 

CB Set assembler argument B=LGO. If the CB 

option is omitted, B=LGO is assumed. 

CB=lfn^ Set assembler argument B=lfn^. 

CB=0 Set assembler argument B=0. 

CL Set assembler argument L=OUTPUT. 

CL=lfn8 Set assembler argument L=lfn3. 

CL=0 Set assembler argument L=0. If this option 

is omitted, L=0 is assumed. 

CS Set assembler argument S=SYSTEXT. If the 

CS option is omitted, S=SYSTEXT is assumed. 

CS=lftig Set assembler argument S=lfn g . f 

CS=0 Set assembler argument S=0. 

CG Set assembler argument G=SYSTEXT. 

CG=lfn- Set assembler argument G=lfn 10 . t t 

CG=0 Set assembler argument G=0. If this option 

is omitted, CG is defined by the CS option. 

For a more detailed description of Modify, refer to the Modify Reference Manual. 

OPLEDIT STATEMENT 

The OPLEDIT control statement removes modification decks and identifiers from a Modify- 
formatted program library file. 

The control statement format is: 

OPLEDIT(p 1 , p 2 , . . . , p n ) 

Pj Any of the following in any order: 

I Use directive input from file INPUT. If the 

I option is omitted, file INPUT is assumed. 

I=lfn 1 Use directive input from file lfnj. 

1=0 Use no directive input. 

P Use file OPL for the old program library. 

If the P option is omitted, file OPL is 
assumed. 

P=lfn2 Use file lft^ for the old program library. 

P=0 Use no old program library. 

N Write new program library on file NPL. 

N=lfn3 Write new program library on file lft^. 

N=0 Write no new program library. If this option 



is omitted, N=0 is assumed. 



t The desired file is retrieved from the system, 
tt The desired file is a local file. 
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L List output on file OUTPUT. If the L option 

is omitted, file OUTPUT is assumed. 

L=lfn 4 List output on file lfn 4> 

L=0 List no output. 

M=lfn g Write output from *PULLMOD directives on 
file lfns. If this option is omitted, ' 
M=MODSETS is assumed. 

LO=x Set list options x; each bit in x, if set, 

turns on the corresponding option. 

001 Errors. 

002 Input directives. 
010 Modifications made. 

100 Directory lists. 

If this option is omitted, x=153 is assumed 
(that is, all options listed). 

F Modify all decks. 

D Debug; ignore errors. 

U Generate *EDIT directives for all decks. 

U=0 Generate no *EDIT directives. If the U 

option is omitted, generate *EDIT directives 
for common decks. 

Z The OPLEDIT control statement contains 

the input directives following the termi- 
nator; the input file is not read. This 
eliminates the need to use a separate input 
file for the directives when only a few 
directives are needed. The first character 
following the control statement terminator 
is the separator character. If Z is omitted, 
the control statement does not contain the 
input directives. 



NOTE 



Do not place another terminator after 
the directives. 

For a complete description of the OPLEDIT utility, refer to the Modify Reference 
Manual. 

PROFILE STATEMENT 

The PROFILE control statement enables the master user to update and inquire about a 
project profile file for user profile control. Other capabilities of PROFILE (available 
only to system origin jobs) are described in the NOS System Maintenance Reference 
Manual. 
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The control statement format is: 
PROFILE (p y p 2 



'Pn> 



Any of the following in any order: 



I=lfn, 



L=lfn«. 



P=lfn, 



CN=cnum 



PN=pnum 



CV 



OP=optn 



LO=isop 



File lfni contains input directives for an 
update (OP=U). If omitted, file INPUT is 
assumed. 

File lfn2 receives output listings. If omitted, 
OUTPUT is assumed. 

File lfh3 is the project profile file. If 
omitted, file PROFILB is assumed. 

Charge number inquire. All project numbers 
valid for charge number cnum are written to 
output file. Valid only if OP=I option specified. 

Project number inquire. The control values 
and all valid user numbers for project num- 
ber pnum are written to the output file. The 
OP=I and CN=cnum options must also be 
specified to use the PN option. 

Convert option. Specifies that directives on 
the input file are in NOS 1. or 1. 1 format 
and are to be converted to update an NOS 1.2, I 
1.3 or 1.4 profile file. Obsolete directives | 
are ignored. OP =U or OP =T option must also 
be specified. 



PROFILE processing option, 
following: 



One of the 



optn Description 

L Lists portions of the profile file 

as specified by the LO parameter. 

U Updates the project profile file 

with directives supplied by the 
input file. U is the default value 
for the master user if the OP 
option is omitted. 

T Time-sharing update. Processing 

is the same as OP=U, but pre- 
liminary instructions are 
suppressed. 

I Inquire option. Output is dependent 

upon CN and /or PN options 
specified, 

PROFILE list option (OP=L must be speci- 
fied). One of the following: 

isop Description 

FM Full list of everything accessible 
on the profile file by the master 
user. This is the default for a 
nonsystem origin job if the LO 
parameter is omitted. 
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CM Charge number list of all charge 
numbers accessible on the profile 
file by the master user. 

PM Project number list of all project 
numbers accessible on the profile 
file by the master user. 

Directives are available to the master user as input to PROFILE' to add or update 
information concerning each charge number. The input file for a PROFILE update 
(OP=U) is divided into groups of entries that each begin with a charge number directive. 
Each directive following a particular charge number entry applies only to that charge 
number, until another charge number entry occurs. 

Each line of the input file can contain one or more directives (up to 72 characters per 
line) in the following format. 

dirj, dir 2 . .... dir n 

Each directive is separated by a delimiter which can be any special character (display 
code greater than 44 g) except the following. 



An end-of-line or end-of-card also delimits directives, 
available to the master user for PROFILE input. 



Description 



The following directives are 




APN=pnum 
AUN=un 
CN=cnum 
DPN=pnum 

DUN=un 
ISV=x 

PEX=yymmdd. 

PN=pnum 

SMA=acc 
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Specifies the charge number cnum to which the following direc- 
tives apply. If this form of charge number specification is used 
(refer to CN=cnum directive), it must begin in column 1 with 
the slash (/). 

Adds or activates project number pnum. 

Adds user number un (must be preceded by PN directive). 

Same as /cnum except that it can begin in any column. 

Deactivates project number pnum. This directive does not delete 
the specified project number entry but sets its status such that 
it cannot be specified by users. 

Deletes user number un from the list of those who may access 
the project number (must be preceded by PN directive). 

Sets x as the maximum SRU accumulation for any job using the 
charge number and project number specified by preceding CN and 
PN directives. 

Specifies expiration date for project number of preceding PN 
directive. If PEX=0 is entered, the project number is not limited 
by an expiration date. 

Project number for which the following directives (until the next 
PN directive) apply. 

Sets the current number of accumulated SRUs the project number 
has used (PN directive required). This accumulator is updated 
at the end of a job or terminal session and each time a CHARGE 
control statement is entered. When the SMA value surpasses 
the SML value, the project is not available to users until either 
the limit or accumulator is respecified. 
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Description 

Specifies the maximum number of accumulated SRUs the project 
(PN directive) may use. SML=0 implies no restriction. 

Specifies the time of day before which the project number 
specified by the PN directive cannot be used. The time is 
specified in 24-hour clock notation. For example, a ti specifi- 
cation of 1315 indicates the project number cannot be used before 
1:15 in the afternoon. 

TO=to Specifies the time of day before which the project number 

specified by the PN directive cannot be used. The time is 
specified in 24-hour clock notation. For example, a ti specifi- 
cation of 1315 indicates that the project number cannot be used 
before 1:15 in the afternoon. 

UPDATE STATEMENT 

The UPDATE control statement edits an Update-formatted program library file. 

The control statement format is: 

UPDATE(pi, p 2 , • • • . P n > 

p i Any of the following in any order: 

A Sequential- to- random program library copy 

B Random -to -sequential program library copy 

C Write compile file output on COMPILE. If 

the C option is omitted, file COMPILE is 
assumed. 

C=lfn. Write compile file output on lfn.. 

C=0 Write no compile output. 

D Compile output has 80 columns for data; if D 

is omitted, compile output has 72 columns 
for data. 

E Update rearranges the directory to reflect the 

actual order of decks on the program library. 
If E is omitted, the old program library 
directory is not edited. 

F Full update; all decks are compiled. If F is 

omitted, corrected decks and those named on 
COMPILE directives are processed. 

on lft^. Any rewind option applying to the 
source file also applies to this file. OUTPUT 
is not a valid file for this option. If G is 
omitted, pulled modifications are appended to 
the source file. 

I Input is on file INPUT. If the I option is 

omitted, file INPUT is assumed. 

I=lfng Input comprises next record on lfhg. 
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K Compile output decks to be written on file 

COMPILE in COMPILE directive sequence. 

K=lfn 4 Compile output decks to be written on lfn 4 in 

COMPILE directive sequence. If this option 
is omitted, output is determined by the C 
option. 

L=char char is a string that specifies any of the A, 

F, and through 9 list options. If this option 
is omitted, options A, 1, 2, 3, and 4 are 
selected. Any use of suppresses listing. 

M Merge input is on file MERGE. 

M=lfn 5 Merge input is on file lfn~. If M option is 

omitted, there is no merge file. 



N 



R 



New program library to be written on file 
NEWPL. 



N=lfn<» NPTO riTTlCTT^Jm H1\mii<it i-n k, 

lfng. If N option is omitted, no new pro- • 
gram library is written. 

O List output to be written on OUTPUT. If 

the O option is omitted, OUTPUT is assumed. 

0=lfn 7 List output to be written on if n7 . If O 

option is omitted, OUTPUT is assumed. 

P Use file OLDPL for the old program library. 

If the P option is omitted, OLDPL is assumed. 

P=Ifn g Use file ifn 8 for the old program library. 

If this option is omitted, OLDPL is 
assumed. 

Q Only decks on COMPILE directives are 

processed. If Q is omitted, corrected 
decks and those named on COMPILE 
directives are processed. 



No rewinds are issued for the program 
libraries, compile file, or source file. 
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R-char Each character in the string char indicates 

a file to be rewound before and after the 
Update run. 

C Compile. 

N New program library. 

P Old program library and merge 

library. 

S Source and PULLMOD. 

Files not specified in char are not re- 
wound. If R is omitted, files are 
rewound before and after the Update run. 

S Source output written on file SOURCE. 

S=lfng Source output written on file lfng. If S 

is omitted, Update does not generate a 
source output file unless the source output 
is specified by T. 
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T Source output excluding common decks on 

file SOURCE. 

T=lfnin Source output excluding common decks on 

x file lfniQ. If T is omitted, no source output 

unless source output is specified by S. 

U Update execution is not terminated by normally 

fatal errors. If U is omitted, Update execu- 
tion terminates upon encountering a fatal 
error. 

W The new program library (refer to N option) 

is a sequential file. If W is omitted, the 
new program library is a random file (unless 
it is a magnetic tape file). 

X Compile file is in compressed format. If X 

is omitted, the compile file is not in com- 
pressed format. 

8 Compile file output is composed of 80-column 

line images. If this option is omitted, com- 
pile file output is composed of 90-column line 
images. 

*=char The master control character (first character 

of each directive) for this Update run is char 
which can be any character having a display 
code octal value in the range 01 through 54 
except for 51 and 52 (the open and close 
parentheses). If this option is omitted, the 
master control character is *. 

/=char The comment control character for this Update 

run is char which can be A through Z, 
through 9, or +-*/$=. The character should 
not be changed to one of the abbreviated 
forms of directives unless NOABBREV is in 
effect. If this option is omitted, the comment 
control character is a slant bar. 

The UPDATE control statement is processed in product set format. For a more 
detailed description of Update, refer to the Update Reference Manual. 



I 
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UPMOD STATEMENT 

The UPMOD control statement converts an Update-formatted program library file to a 
Modify-formatted program library file. 

The control statement format is: 

UPMOD(p 1 , p 2 , . . . , p n ) 

p. Any of the following in any order: 

P Update program library from file OLDPL. 

If the P option is omitted, file OLDPL is 
assumed. 

P=lfnj Update program library from file lfnj. 

N Modify program library on file OPL. 

N=lfn Modify program library on file lfn^. 

M Modify program library name is OPL. If 

the M option is omitted, file OPL is as- 
sumed. 

M=lfng Modify program library name is lfhg. 

F Convert to file mark. 

NR Do not rewind file lfhj. 

The Update file must be in sequential format. A random Update file must first be 
changed to sequential format via Update before being submitted to UPMOD for conversion. 
Unless otherwise specified, only one record from the Update file is converted. After 
the Modify OPL has been created, no references should be made to modset identifiers 
present on the Update library. The new OPL should be treated as any other program 
library created by a Modify creation run. 
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XEDIT STATEMENT 

The XEDIT control statement calls the text editor, XEDIT. For a complete description of 
XEDIT parameters and commands, refer to the XEDIT Reference Manual. 

The control statement format is: 

XEDITdfn-, Pj, p 2 » • . • . p n >delimited command sequence 

Ail parameters are optional. The following are brief parameter descriptions. 

lfn Name of the file to be edited. If lfn x is omitted (indicated by 

two separators before other parameters), the primary file is 
edited. 

p. One or more of the following parameters in any order. 

AS Edit lfnj in ASCII time-sharing mode. After the 

XEDIT job step, processing returns to the original 
mode. 

B Process the job as a batch origin job. 

C Create a new file lfn.. 

FR Take the first editing command from the first line 

of lfn-. 

^lfiu Take editing directives from lfn2- If I is omitted, 
commands are taken from file INPUT. 

1=0 Take all editing directives from the trailing de- 

limited command sequence. (If the FR parameter 
is also specified, process the delimited command 
sequence after processing directives from the 
first line of lfn.. ) 

L=lfn 3 Put all XEDIT output on the specified file. 

L=0 Suppress all output. 

NH Suppress printing of the XEDIT header. 

P Retrieve and edit permanent file lfnj. Direct 

access files are attached in write mode. If P is 
omitted, the file lftij is assumed to be a local file. 

delimited Command sequence with the following format (; represents the 

command delimiter character). 

sequence 

jcommand, ;command 9 ;. . . jcommand 



60435400 J 1-13-13 • 



LIBRARY MAINTENANCE 14 



A library is a file containing records that are accessed individually. Library records 
can be of several types and can be accessed randomly or sequentially. 

This section describes library access methods, library record types, and the following 
control statements and their functions. 

CATALOG Describes the records on a file. 

GTR Appends records selected from one file to another file. 

LIBEDIT Generates a file containing records from one or more other files. 

The records may be of several types. LIBEDIT handles a LIBGEN - 
generated library as a single record. 

LIBGEN Generates a user library, that is, a library of relocatable and capsule 

records that can be accessed by CYBER Loader. 

VFYLIB Compares the records in two files and lists their differences. 

FILE ACCESS METHODS 

The methods used to access records within NOS files are sequential access and random 
access. 

To access a record sequentially, NOS rewinds the file to BOI and then reads records 
until it finds the requested one. To replace, insert, or delete records from a se- 
quential access file, NOS must rewrite the entire file. (Records can be appended at 
EOI without rewriting the file. ) 

To access a record randomly, the file must be on mass storage and must have a 
directory containing the address of each record (figure 1-14-1). The GTR, LIBGEN, 
and LIBEDIT statements can generate random access directories. Records within a 
file can then be replaced, inserted, or deleted by rewriting the directory instead of 
rewriting the entire file. Records within a random access file can also be accessed 
sequentially. 
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Figure 1-14-1. Random Access File Structure 

LIBRARY RECORD TYPES 

The following record types can be specified on the GTR and LIBEDIT control state- 
ments and are recognized by the CATALOG and VFYLIB statements. LIBGEN generates 
a user library from relocatable (REL) and capsule (CAP) records. 

Mnemonic Meaning 

ABS Multiple entry point overlay. 

CAP CYBER Loader capsule. 

COS Chippewa format CPU program; COMPASS or FORTRAN source with 

errors that suppressed binaries. 

OPL Modify old program library deck. 

OPLC Modify old program library common deck. 

OPLD Modify old program library directory. 

OVL Central processor overlay. 

PP Peripheral processor program. 

PPU Peripheral processor unit program. 

PROC CCL procedure file. 

REL Relocatable central processor program. 

TEXT Unrecognizable as a program. 

ULIB User library directory. 

Appendix G in volume 2 contains the formats of PP, OPL, OPLD, ULIB, and TEXT 
records. (The OPLC record format is identical to that of the OPL record.) The 
NOS Modify Reference Manual describes how to create OPL, OPLC, and OPLD records. 
The CYBER Loader Reference Manual contains the formats of ABS, CAP, OVL, PP, 
and REL records. The CYBER Loader Instant contains the PPU record format. Sec- 
tion 4 describes the creation of CCL procedures (PROC). 
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A user determines the record types contained in a file by issuing a CATALOG state- 
ment naming the file. VFYLIB lists the differences between the record types of two 
files. 

CATALOG STATEMENT 

The CATALOG control statement lists information about each record in a file assigned 
to the job. 



NOTE 



CATALOG produces unpredictable results when 
attempting to catalog an S, L, or F format tape. 
The user should use the COPY statement to con- 
vert the S, L, or F format tape to a mass stor- 
age file or to an I or SI binary format tape be- 
fore attempting to catalog the file. 

The control statement format is: 

CA TA LOGOfn, p 1# p 2 , . . . , p n ) 

lfn Name of the file to be cataloged. 

Pj May be any of the following. 

N=0 Catalog until an empty file is encountered (two 

consecutive EOR marks). 

N=n Catalog n files; if N is omitted, N=l is assumed. 

N Catalog until EOI is encountered. 

L=fname Specifies the name of the output file; if L is 
omitted, CATALOG assumes LOUTPUT. 

U Lists records within a user library; if U is 

omitted, only the ULIB record within the user 
library is listed. 

D Suppresses the comments field; suppresses all 

page headings after the initial page heading for 
each file. 

CS Suppresses character set indicator (63 or 64) 

for OPL and OPLC records. 

E Rewinds lfn before and after cataloging; if E is 

omitted, lfn is not rewound. 
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The listing for each file of a multifile. file begins on a new page with a page heading 
for that file. If the D option has been specified, the page heading appears only once, 
at the beginning of the file. The information listed under each heading is as follows: 

Heading Information 

REC Record number (zero-length records and EOF marks are counted). 

NAME Record name [the contents of the name field from the second word 

of the prefix (77) table, if present; otherwise, the first 7 char- 
acters of the record], 

TYPE Record type (refer to Library Record Types in this section). 

LENGTH Record length in words (less prefix table length) printed as an 

octal number. 

CKSUM A checksum [a value used to verify that the contents of a record 

fpYflllflinrf tVlO r>T>efi-v +aKI«»\ trrooo nnnioil „~»v«,v~4.1„1 



DATE Record creation date (taken from the third word of the prefix 

table, if present). 

COMMENTS Additional information taken from the prefix table, if present; 

message terminates before COPYRIGHT comment. (This field is 
not shown when CATALOG is used in a time-sharing job.) 

CATALOG lists additional information depending on the record type. Entry points are 
listed for REL and ABS records. The character set used, correction identifiers, and 
their YANK status (refer to the NOS Modify Reference Manual) are listed for OPL and 
OPLC records. 

If the TEXT record name begins with CMRDC, CRMDECK, IPRDC, IPRDECK, LIBDC, 
or LIBDECK, CATALOG lists the entire record. If the TEXT record name begins 
with OVERLAY, CATALOG lists the first line in the record. 

A ULIB record suppresses listing of the other records in the user library unless the 
U parameter is specified on the control statement. 

When a zero-length record is encountered, the. length since the last zero-length record 
is given. If an EOR does not precede an EOF or EOI within the cataloged file, the 
following message is output before the * EOF * or * EOI * line. 

* EOR MISSING * 

The ITEMIZE control statement (described in the Common Utilities Reference Manual) 
is similar to the CATALOG statement, but ITEMIZE recognizes additional record types. 

Example: 

Compilation of the FORTRAN Extended program A and its subroutines B and C wrote 
relocatable object code on file L. The following is a catalog of file L (refer to the 
heading definitions given earlier). The I/O file names listed in the FORTRAN Extended 
PROGRAM statement are flagged by # characters. 
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LENGTH 


1 
CKSUM 


DATE 


COMMENTS 


79/02/27. 16. 


13 


.27. 


PAGE 


1 


1 


J 

A 

IHPUT* 

OUTPUT! 

TAPE6I 
3 

B 


REL 


114 


0706 


79/02/27. 


IS. 13.13 


SOS 1.1 FTN 




H.7135 


666X I 


PROGRAM 


2 


REL 


25 


into 


79/02/27. 


16.13.13 


SOS 1.1 FTN 




1.7155 


66&X I 


SUBROUTINE 


3 


: 
c 


REL 


25 


1150 


79/02/27. 


16.13.13 


NOS 1.1 FTN 




1.7185 


665X I 


SUBROUTINE 


1 


• EOF • 


SUM = 


loo 



















GTR STATEMENT 

The GTR control statement appends records selected from one file to the end of another 
file. The records are selected according to directives specifying their type and name. 
Records can be accessed randomly (default if a directory exists) or sequentially. If 
specified, a random access directory is appended to the changed file. GTR cannot 
append records after the directory. 

The control statement format is: 

GTRQfnp lfn 2 , D,NR,S, NAJdirectivej, directive2, .... directive n 



NOTE 



The parameters must be in the order shown. 
GTR identifies its parameters by their position, 
not by keywords. An omitted parameter is de- 
noted by consecutive commas. Blanks are illegal 
between the terminator (right parenthesis or 
period) and directive! . 



The parameters are defined as follows: 



lfn. 



lfn, 



File which is searched for the requested records; if lfni is 



omitted, file OLD is assumed, 
the GTR operation. 



Ifnj is always rewound Def ore 



File on which the selected records are written; if lfn2 is omitted, 
file LGO is assumed. GTR always positions lfn 2 at EOI before 
copying the selected records. 

Writes a random access directory (OPLD) at the end of lfn 2 . 

If D is specified, lfn 2 must be a mass storage file. GTR cannot 

append records after a directory. 

This parameter has special meaning when the ULIB (user library) 
record type is specified in the directives. 
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NR 



S 
NA 

directive* 



If D is omitted, the first record of the user library, the user 
library directory (ULIB), is not copied to lfti2; the last record 
(OPLD) is copied but not altered. 

If D is specified, the first record of the user library (ULIB) is 
copied without alteration to lfn 2 along with the relocatable records 
and the old random access directory (OPLD). A new random 
access directory (OPLD) for the file is also added to lfti2. 

If NR is specified, lfnj is not rewound after the operation; lfn 2 
is not rewound before or after the operation. If lfnj has a 
directory, the directory is copied to lfn 2 . 

If NR is omitted, both files are rewound before and after the 
operation. 

lfnj is searched sequentially; no attempt is made to read a 
directory. 

If specified, GTR does not search for an EXIT statement when 
an error occurs. It issues a dayfile message for the error and 
continues GTR processing at the next directive. 

Specifies a record or group of records to be retrieved. One or 
more of the following formats can be used. Valid record types 
are listed under Library Record Types in this section. The 
default type is the last type specified on a directive, or if none 
specified, TEXT. The record name is the first 7 characters of 
the record, or if a prefix table is present, the contents of the 
name field in its second word. 



Directive 
type /name 
name 



typei/namei- 
type2/name2 

tyP e 1 1 'name j- 
name2 

name r name 2 



type /name-* 

name-* 

type/* 



Meaning 

Record with the specified type and name. 

Record with the specified name and the de- 
fault type. 

Group of records beginning with namei of 
type} and ending with name 2 of type 2 . 

Group of records beginning with name^ of 
typej and ending with name 2 of typej. 

Group of records beginning with namei of 
the default type and ending with name2 of 
the default type. 

All records of the specified type beginning 
with the named record. 

All records of the default type beginning with 
the named record. 

All records of the specified type. 
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Directive Meaning 

* All records of the default type. 

A zero-length record is inserted. 

GTR searches file lfn, for the records specified by the selection directives. If GTR 
cannot find a record specified by type and name, it issues the following dayfile mes- 
sage. 

GTR ERRORS. 

It also issues this message when the record specified is -within a user library and 
when the GTR statement syntax is incorrect. 

If lfn2 is on tape, the selected records are copied from the current file position; if 
Ifno is on mass storage, the copy starts at the current EOI of the file. 

Examples : 

• GTR(SYSTEM,BIN,D)PP/* 

GTR copies all PP records from file SYSTEM to file BEST. It then builds a 
random access directory and writes it as the last record on BIN. 

• GTR(OPL,NEW, ,NR)OPLC/COMCARG, O.COMCCIO 

GTR retrieves common decks COMCARG and COMCCIO from file OPL. It 
then writes COMCARG, a zero-length record, and COMCCIO at the current 
position of file NEW. NEW is not rewound before the operation; OPL and 
NEW are not rewound following the operation. 

• GTR(SYSTEM,SYSLIB,D)ULIB/SYSLIB 

GTR copies the user library SYSLIB from file SYSTEM to the end of file 
SYSLIB. 

• GTR.REL/A 

GTR retrieves the relocatable record A from file OLD and copies it to file 
LGO. 

LIBEDIT STATEMENT 

LIBEDIT is a general-purpose utility that generates a file containing records copied 
from one or more other files (figure 1-14-2). LIBEDIT can build a random access 
directory for the new file. It recognizes the record types listed in Library Record 
Types in this section. LIBEDIT processes a user library as a single record. 

LIBEDIT can edit a library according to directives requesting addition, deletion, or 
replacement of specified records from one or more replacement files. Replacement 
is the implicit mode of a LIBEDIT run. The user must explicitly identify records to 
be added and records that are not to be replaced (refer to the description of the 
NOREP directive). 
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LIBEDIT executes in two phases. During the first phase, it reads directives and re- 
placement records. It groups directives by type and file and groups changes when 
several insertions take place relative to the same record. 

During the second phase, LIBEDIT writes the new file. If LIBEDIT cannot process 
the specified combination of directives, and the D option (refer to the following control 
statement description) was not specified, LIBEDIT lists its interpretation of the con- 
flicting directives, issues an error message, and aborts the job step. If the D option 
was specified, LIBEDIT continues processing the directives. 




Figure 1-14-2. LIBEDIT Input and Output 



CONTROL STATEMENT FORMAT 

The following control statement calls LIBEDIT. Its parameters specify options and 
files used for the call as illustrated in figure 1-14-2. 

LIBEDITfcp p 2 , . . . , p n ) 

The option parameters pj can be in any order. Each parameter cannot be specified 
more than once, lfn is a file name of 1 to 7 alphanumeric characters. 

Pi Meaning 

P=lfn x Edit file lfnj (the old file). 

P=0 No old file; new file created from replacement file(s). 

P omitted Edit file OLD. 

N=lfn2 Write new file on file lfn. 

N=0 Illegal; error message issued. 

N omitted Write new file on file NEW. 
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Meaning 



I=lfn 3 

1=0 

I omitted 



| NOTE | 

The new file is evicted prior to processing (refer 
to the EVICT statement in section 7). 

Take directives from the next record of lfn3 . 

No directive input. 

Take directives from file INPUT. 



B=lfn4 Use records from file lftu for insertions and replacements. 

B=0 No replacement file used (unless specified by a FILE directive). 

B omitted Use file LGO as a replacement file. 

LO=lfn5 List output on file lfn 5 . 

LO=0 * List no output. 

LO omitted List output on file OUTPUT. 

L=l List directives, modifications, and errors on output file. 

L=0 List only errors. 

L omitted Same as L=l. 

V Call VFYLIB after LIBEDIT processing. 

V omitted Do not call VFYLIB. 

R Do not rewind files after processing. 

R omitted Rewind old and new files after processing. 

C Copy the new file over the old file after processing. 

C omitted Do not copy the new file over the old file. 

D Ignore errors and continue. 

D omitted Do not ignore errors; abort job step. 

LIBEDIT DIRECTIVES 

The user can specify directives to control LIBEDIT processing. These directives 
can be in a record on file INPUT or on the file specified by the control statement I 
parameter. 

Directives are not required. If 1=0 is specified, LIBEDIT compares the name and 
type of each record on the old file with those of the records on the replacement file 
(specified by the B parameter). If a record with the same name and type appears 
on the replacement file, LIBEDIT writes that record on the new file and skips the 
record on the old file; otherwise, it copies the record from the old file to the new 
file. If 1=0 and B=0 are specified, LIBEDIT copies the old file to the new file until 
it encounters an EOF mark or an OPLD directory on the old file. 

LIBEDIT recognizes the following directives. 
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Directive 



Function 



*ADD 

♦BEFORE or ♦B 
*BUILD 
♦COMMENT 
*COPY 
♦DATE 

♦DELETE or ♦D 
♦FILE 

♦INSERT or +1 

or 

♦AFTER or +A 

♦NOREP 

♦RENAME 
♦REPLACE 

♦REWIND 

♦TYPE or 

♦NAME 



Inserts records before a zero-length record within the file. 

Inserts record before the named record. 

Builds a directory at the end of the new file. 

Adds a comment to the prefix table. 

Copies the new file to the old at the end of editing. 

Adds the date and a comment to the prefix table. 

Does not copy specified records to the new file. 

Declares a file to be a replacement file. 

.ignores records Wi±en reauing luc replacement ixle. 

Copies record from the replacement file after copying the 
specified old file record. 

Does not automatically replace old file records with records 
from the specified file. 

Rename record. 

Replaces the named records from the old file with records 
from the replacement file. 

Names file to be rewound before and after editing. 

Sets default record type. 



Directive Syntax 

A directive begins with an asterisk in column 1 followed immediately by the directive 
identifier. The directive identifier is delimited by a comma and/or one or more 
spaces. If a directive does not begin with an asterisk and a directive identifier, 
LIBEDIT assumes that the operation is a continuation of the previous directive opera- 
tion. If an asterisk and directive identifier do not begin the first line of the directives 
record, LIBEDIT prefixes the following to the first line. 

♦BEFORE *. 

Parameters are delimited by a blank, an end-of-line, or a comma. A hyphen (-) 
indicates a record group. Record group identifiers (gid entries) cannot be split be- 
tween lines. For example, the lines 

♦B,OVL/Pl,OVL/P2,OVL/P 
3 
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do not constitute a valid directive. The last entry would not be processed as OVL/P3. 
On the other hand, the lines 

*B,OVL/Pl,OVL/P2 
OVL/P3 

do constitute a valid directive and would be processed as: 

*B,OVL/Pl,OVL/P2,OVL/P3 

Parameters common to many directives are the reference record identifier (rid) and 
the record group identifier (gid). Valid record types for these parameters are listed 
in Library Record Types in this section. The default type is the last type specified 
in a directive; if none are specified, TEXT is the default. The record name is the 
first 7 characters of the record, or if a prefix table is present, the name in its 
second word. The first character of a record name specified in a directive must 
not be an asterisk. 



rid 



Reference record identifier specifying the reference point for the 
requested change. It can have the following formats. 



gid 



type /name Reference record has the specified type and 

name. 

name Reference record has the specified name and 

is of the default type. 

* Reference point is an end-of-file mark (used 

with *BEFORE directive only). 

Record group identifier indicating a record or group of records to 
be inserted, deleted, or replaced. It can have the following 
formats. 



type /name 
name 



type- /name j - 
typ e 2 /name2 

typej/name^- 
name2 



oame.-name. 



type /name-* 



name-* 



type/* 



Record with the specified type and name. 

Record with the specified name of the default 
type. 

Group of records beginning with name, of 
type* and ending with name2 of type2« 

Group of records beginning with name, of 
typej and ending with name2 of type^. 

Group of records beginning with name, of 
the default type and ending with name2 of the 
default type. 

All records of the specified type beginning 
with the named record. 

All records of the default type beginning with 
the named record. 

All records of the specified type. 

All records of the default type. 

A zero-length record is inserted. 
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ADD 

The ADD directive inserts records before a zero-length record. A CATALOG listing of 
the old file numbers each group of records ending with a zero-length record (called a 
library on the listing). This number on the ADD directive identifies the record group. 



| NOTE 



Adding a zero-length record does not change 
the directory. 



The directive format is: 
*ADD LIBn.gidpgid-, 



•g id n 



LIBn Specifies the record group to which the records are appended. 

Values for n are 1 to 63 and can be determined from a CATALOG 
listing of the old file. 

gidj Identifies the records or groups of records from the current 

replacement file that are to be inserted before the zero-length 
record. e 

Example: 

The following is a CATALOG listing of file Q. 



:c 


CATALOG OF Q 
NAME TYPE 


FILE 
LENGTH 


1 
CKSUM 


1 

2 
3 


REC1 
REC2 
(00) 


TEXT 
TEXT 

SUM = 


1 

1 
2 


5302 

5304 

LIBRARY 


H 


REC4 


TEXT 


1 


5310 




* EOI * 


SUM = 


3 





DATE 



The following output results when a record was added to file Q, producing file Y. 



LIBEDIT DIRECTIVE CARDS. 

•ADD LIB1.REC3 
RECORDS WRITTEN ON FILE Y 

RECORD TYPE FILE 

REC1 TEXT Q 

REC2 TEXT Q 

INSERTED REC3 TEXT X 

00 Q 



REC4 

**E0F«* 



TEXT 



DATE COMMENT 



78/11/13. 15.12.51. 



78/11/13. 15.12.51. 



PAGE 1 
PAGE 2 
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BEFORE 

A BEFORE directive inserts records or groups of records before a specified reference 
record on the old file. An old file record with the same name and type as an in- 
serted record is not copied to the new file. 

The directive formats are: 

*BEFORE rid,gid 1 ,gid 2 ,...,gid n 

or 

*B rid, gidj, gid 2 , . . . , gidjj 

rid Names the old file record before which the specified replacement 

file records are to be inserted. 

gid. Identifies records or groups of records from the current replace- 

ment file that are to be inserted before the reference record (rid). 

If the first line of the LIBEDIT directives record does not begin with an asterisk and 
directive name, LIBEDIT assumes that the line is the gid parameters following a 
#BEFORE *, directive. 

BUILD 

A BUILD directive constructs and appends a random access directory to the new file. 
The directory is in Modify format (an OPLD record). If the old file has an OPLD 
directory, LIBEDIT constructs a directory for the new file with or without a BUILD 
directive. BUILD can also be used to change the directory name. 

The directive format is: 

*BUILD dname 

dname 1- to 7-alphanumeric character name for the directory record. 

No default. 

COMMENT 

The COMMENT directive adds a comment to the prefix (77) table of a record written 
on the new file. 

The directive format is: 

^COMMENT rid comment 

rid Name of a record to be written on the new file. 

comment A string of up to 40 characters that appears in the comment 
field of the prefix table. Additional characters are truncated. 
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COPY 

The COPY directive directs LIBEDIT to copy the new file over the old file after it 
has processed all directives. 

The directive format is: 

*COPY lfng.lfnj 

lfi^ Name of new file to be copied over old file. 

lfnj Name of old file to be overwritten. 

It performs the same function as the C parameter on the LIBEDIT control statement. 
If files other than the old file and the new file (as specified on the LIBEDIT state- 
ment) are named, the directive is ignored. 

nirc 
»#*-.■■» 

The DATE directive adds the current date and the specified comment to the prefix 
(77) table of a record written on the new file. 

The directive format is: 

*DATE rid comment 

rid Record to be written on the new file. 

comment A string of up to 40 characters to be written in the comment 
field of the prefix table. Additional characters are truncated. 

DELETE 

The DELETE directive suppresses copying of the specified records from the old. file 
to the new file. 

The directive formats are: 

*DELETE gidj , gid 2 , . . . , gidjj 

or 

*D gid 1 ,gid 2 ,...,gid n 

gid 4 Identifies records or groups of records that are not to be copied 

from the old file to the new file. 

Example: 

*DELETE OVL/LAD-REL/RUN 

This directive requests LIBEDIT not to copy the sequence of records starting with 
overlay LAD through relocatable CPU program RUN. 
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FILE 

The FILE directive names a file assigned to the job that contains replacement records. 
LIBEDIT directives following the FILE directive refer to records on the declared re- 
placement file. 

The directive format is: 

*FILE Ifn 

Ifn l- to 7-character name of a replacement file. If Ifn is an 

asterisk (*), LIBEDIT uses the replacement file specified by 
the LIBEDIT control statement. If the B parameter was omitted 
from the control statement, LGO is used. 

ION ORE 

The IGNORE directive requests LIBEDIT to ignore a record or group of records on 
the current replacement file. 

The directive format is: 

*IGNORE gid lf gid 2 , . . . , git^ 

gidi Identifies records or groups of records on the replacement file 

that are to be ignored. 

Example: 

*FILE ALPHA 
*IGNORE C-* 

LIBEDIT ignores the sequence of records on file ALPHA starting with record C of 
the default type and including all records of the default type from C to the EOF mark. 

INSERT OR AFTER 

The INSERT or AFTER directive requests LIBEDIT to copy the specified records 
or groups of records from the current replacement file after it has copied the speci- 
fied old file record onto the new file. Any record on the old file that has the same 
name and type as an inserted record is not copied to the new file. 

The formats for the directives are: 

*INSERT rid,gid 1 ,gid 2 ,...,gid n 

or 
*I rid, gid 1 ,gid 2 ,,..,gid n 
*A FTEB rid, gidj , gid 2 , . . . , gidjj 

or 
*A rid, gidj , gid 2 , . . . , gid R 
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Example: 

*EMSERT OPL/K.TEXT/L 

This directive requests LIBEDIT to copy the replacement file text record L to the 
new file after it has copied the old file OPL record K. 

NOREP 

The NOREP directive declares the specified files to be no-replace files. A no-replace 
file is a replacement file whose records do not automatically replace old file records 
having the same name and type. The user selects records to be written on the new 
file from no-replace files by specifying the file on a FILE directive and then naming 
the records on *AFTER, *BEFORE, *INSERT, and *REPLACE directives. 

The directive format is: v 

♦NOREP lfn..lfn„ lfn_ 

RENAME 

The RENAME directive assigns a new name to a record written on the new file. If 
the renamed record is referenced by another directive in the directive record, the 
old name should be used. A RENAME is not allowed on a PROC record. 

The directive format is: 

♦RENAME rid, name 

rid Name of the replacement file record or old file record to be 

renamed. 

name 1- to 7- alphanumeric character new name of the record. 

REPLACE 

The REPLACE directive requests LIBEDIT to replace the old file records having the 
specified names and types with the replacement file records having matching names 
and types. This directive is used when the current replacement file has been de- 
clared a no-replace file (refer to the NOREP directive description). If the replace- 
ment file is not a no-replace file, LIBEDIT performs the replace operation auto- 
matically. 

The directive format is: 

♦REPLACE gid 1 ,gid2,....gid n 

gidj Specifies records or groups of records that appear on both the 

old file and the current replacement file. 



1-14-16 60435400 J 



Example: 

The old file contains text records A, B, C, and D; the replacement file RF also 
contains text records named A, B, C, and D. Either of the following directive 
sequences writes records A and B from the old file and records C and D from file 
EF onto the new file. 

Sequence 1 Sequence 2 

*FILE RF *FILE RF 

*NOREP RF *IGNORE A-B 

*REPLACE C-D 

REWIND 

The REWIND directive tells LIBEDIT to rewind the specified file before and after 
processing. 

The directive format is: 

*REWIND lfn 

Ifn Name of the file to be rewound. 

TYPE OR NAME 

A TYPE or NAME directive sets the default record type. 

The directive formats are: 

*TYPE type 
*NAME type 

type Specifies default record types. Valid record types are listed in 

Library Record Types in this section. 

The default record type can also be set by an explicit record type specification within 
a directive. In either case, the default record type setting remains in effect until 
another record type is explicitly named. If a default record type is not declared in 
the directive sequence, the default is TEXT. For example, the following two direc- 
tive sequences are equivalent. 

Sequence 1 Sequence 2 

*TYPE REL *INSERT REL/X.Y 

*INSERT X,Y *DELETE FILE1-FILE4 

*DELETE FILE1-FILE4 
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LIBEDIT OUTPUT 

LIBEDIT interprets all directives in the directive record before beginning directive 
processing. If one or more errors are found, LIBEDIT issues the dayfile message 

DIRECTIVE CARD ERROR. 

and aborts the job step (unless the D parameter is specified on the control statement). 
The following LIBEDIT output shows the results of a directive syntax error (the FILE 
directive is not followed by a space or comma). 



LIBEDIT DIRECTIVE CARDS. 
•ERROR* "FILERF1 



78/11/15. 10.36.H7. 



PAGE 



uii-ectivea which cannot be executed are listed as LIBEDIT interpreted them. The 
following LIBEDIT run called for a replacement file not assigned to the job. 



LIBEDIT DIRECTIVE CARDS. 

•FILE RF1 
•B »,X 
•ERROR* DIRECTIVE CARD CAM NOT BE FOLLOWED 
•FILE RF1 
•BEFORE TEXT/»,TEXT/X 



78/11/15. 10.37.39. 



PAGE 



Nonfatal errors are listed in an error directory following the listing of records written 
to the new file. The RECORDS NOT REPLACED error shown in the following example 
could be corrected by including an *IGNORE directive naming the records not to be 
replaced. 



LIBEDIT DIRECTIVE CARDS. 

•FILE RF2 
•B »,REC1 

RECORDS WRITTEN ON FILE NEV 

RECORD TYPE FILE 

INSERTED 3EC1 TEXT HF2 

"EOF" OLD 



DATE 



COMMENT 



ERROR DIRECTOR! - RECORDS MOT REPLACED. 
RECORD TYPE FILE 
REC3 TEXT RF2 
REC1 TEXT RF2 



79/02/29. 03.37.13. 



79/02/23. 08.37.13. 



79/02/23. 03.37.13. 



PACE 
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LIBGEN STATEMENT 

The LIBGKN control statement generates a user library of routines for use with 
CYBER Loader. The control statement format is: 

LIBGEN (p 1 ,p 2 ,...,p n ) 

Any of the following parameters may be specified in any order (only one instance of 
each) . 

p. Meaning 
_u £ 

F^nj Source file containing the relocatable (REL) and/or capsule (CAP) 

records for the user library. Other record types are ignored. 

F or F LGO is the source file, 
omitted 

P=lfn 2 File on which the user library is to be written. 

P or P User library is to be written on file ULIB. 
omitted 

N=name Name of the user library generated; name entered in ULIB and OPLD 
records. 

N or N User library name specified by P parameter, 
omitted 

NX=n If n is not zero, no cross-references are included in the ULIB directory. 

If n is zero, cross-references are included. 

NX or NX LIBGEN assumes NX=0 (cross-references are included in the directory), 
omitted 

If the F and P parameters specify the same file, LIBGEN issues a dayfile message 
and does not generate a user library. 

Figure 1-14-3 illustrates the structure of a user library. To generate a user library, 
LIBGEN rewinds and scans the source file, building a directory of all entry points, 
program names, and external references in the relocatable and capsule records in the 
file. LIBGEN then copies the source file to the user library file adding the ULIB and 
OPLD records. 

Unless the NX parameter specifies otherwise, the ULIB directory contains the external 
reference /entry point linkage between routines in the user library. When CYBER 
Loader loads a routine from the user library, it loads (at the same time) all user 
library routines referenced by the requested routine. All externals for user library 
routines are satisfied from the user library, if possible. If desired, the user can 
request with the NX parameter that the ULIB directory contain no cross-linking of 
records. In that case, when a routine from the user library is requested, only that 
routine is loaded. 
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ULIB 


) 


REL 


1 


REL 


REL 


OPLD 


I 



User library directory 



Relocatable routine* 



Random access directory 



Figure 1-14-3. User Library Structure 



Example 1". " 



Pile RELB contains relocatable routines that are used for execution of several applica- 
tions. To enable loading of these routines as needed during execution of an application 
program, the user generates a user library using the following control statement. 

LIBGEN(F=RELB, P =MYLIB, N=APPLIB) 

This creates user library APPLIB on file MYLIB. The following loader sequence 
allows use of the APPLIB routines during execution of a compiled FORTRAN Extended 
program on file LGO. 

LDSET(LIB=MYLIB) 
LOAD(LGO) 

EXECUTE. 

The program is loaded and executed with externals satisfied first from user library 
MYLIB and then from the system default library SYSLIB. Refer to the CYBER Loader 
Reference Manual for more information on library search procedures. 

Example 2: 

If a routine has no external references, no entry is made in the ULIB directory. To 
load this routine, the user must include the loader statement LDSET(USEP =pname) in 
a loader sequence. 

Suppose a FORTRAN Extended program contains a BLOCK DATA subroutine without 
external references to any of its entry points. The user has not named the block, and 
it has the default name BLKDAT. To load this routine, the user must include the 
following control statement in the loader sequence. 

LDSET(USEP =$BLKDA T. $) 

VFYLIB STATEMENT 

The VFYLIB control statement rewinds two files, compares their record sequence, and 
lists the differences. VFYLIB lists changes in residence (between record groups sep- 
arated by zero-length records), replacements, deletions, and insertions. A record is 
defined as being replaced when its name and type remain the same, but its contents 
differ. VFYLIB does not compare prefix (77) table information such as last modifica- 
tion date and last assembly date. 
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The control statement format is: 
VFYLIBdfnj, lfn 2 , lfn 3 , NR) 



lfnj 
lfn 2 
lfn 3 
NR 



Name of the first file; if this parameter is omitted, VFYLIB 
assumes file OLD. 

Name of the second file; if this parameter is omitted, VFYLIB 
assumes files NEW. 

Name of the output file; if this parameter is omitted, VFYLIB 
assumes file OUTPUT. 



If specified, lfn« and lfn, are not rewound after verification. 
Example: 
The following are CATALOG listings of file OLD and file NEW. 



REC 


CATALOG 
NAME 


OF OLD 
TYPE 


FILE 
LENGTH 


1 

2 


A 

A 
(00) 


BEL 

SUM s 


25 
25 


i 

1 


B 

3 
C 

C 


REL 
KEL 


25 
25 


5 


* EOF » 


SUM = 


77 



1 

CK3UM DATE 

75 1 *? 79/02/23. 

IBRARY s 1 

1110 79/02/23. 

11150 79/02/23. 



re; 



.c 


CATALOG 
NAME 


OF NEW 
TYPE 


FILE 
LESGTH 


1 
CKSliM 


DATE 


1 


A 


REL 


30 


4122 


79/02/28. 


2 


B 
B 
COO) 


REL 


25 


41)10 


79/02/23. 


3 


3UH = 


35 


LIBRARY 


: 1 


« 


D 


TEXT 


1 


1000 




5 


» EOF » 


SUM - 


55 







The control statement, VFYLIB. , produces the following listing. 



VFYLI8. OLD FILE = OLD HEV FILE = SEW 79/02/23. 03.53.32. 
RECORD TYPE ULIB LI3 DATE COMMENT 



PAGE 1 



RECORDS REPLACED. 

A REL 

CHANGES IS RESIDENCE. 

B REL 
DELETED PROGRAMS. 

C DEL 
IH3ERTED PROGRAMS. 

S TEXT 



1 79/02/23. 03.56.01) :I0S 1.1) FT1I 11.7135 66SX I 



1 79/02/23. 03.43.HI 103 l.D FTH 1.7«95 565X I 



2 ' 79/02/23. 03.40.111 103 1.4 FTH 4.7435 655X I 



SUBR1UTIHE0PT=1 



SUBROUTIKEOPTsI 



SUBS0UTIHE0PT=1 
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LIBRARY PROCESSING EXAMPLES 

The following examples illustrate the use of CATALOG, GTR, LIBEDIT, -and LIBGEN 
control statements. To duplicate the examples, the user should execute the jobs in 
sequence. 

Example 1: 

The following job builds a program library from a replacement file of relocatable 
binary (RED records. 

LIBTES1. 
USER(EFD25,PW) 
CHARGE(16, 13N122) 
FTN(L=0) 
DEFINE(TESTLIB) 
CATALOG(LGO,R) 
LIBEDITfP =0. N =TESTLIB> 
CA TA LOG(TESTLIB, R) 
-EOR- 

SUBROUTINE A 

STOP 

END 

SUBROUTINE D 

STOP 

END 

SUBROUTINE C 

STOP 

END 

SUBROUTINE B 

STOP 

END 
/EOR 

*BUILD LIBRARY 
*B,*,REL/A,B,C,D 
/EOF 

The FORTRAN Extended compilation produces relocatable binaries on the default file 
LGO. The DEFINE statement creates a direct access permanent file TESTLIB on 
which the new program library is written. The first CATALOG statement lists the 
LGO file as follows: 



REC 


CATALOG 
NAME 


OF LGO 
TYPE 


FILE 
LENGTH 


1 
CKSUM 


DATE 


COMMENTS 


79/03/01 


. 08. 


17 


.27. 


PAGE 




1 


1 


A 

A 


D 

C 
3 
3 


REL 


25 


7517 


79/03/01. 


03.16.29 


SOS 1.1 


FTN 




4.7435 


666X 


I 


SUBROUTINE 


2 


REL 


25 


6705 


79/03/01. 


08.16.29 


N0S 1.4 


FTN 




4.7435 


S66X 


I 


SUBROUTINE 


3 


REL 


25 


1*50 


79/03/01. 


03.15.29 


N0S 1.4 


FTN 




4.7435 


666X 


I 


SUBROUTINE 


u 


REL 


25 


4410 


79/03/01. 


08. 16.29 


N0S 1.4 


FTN 




4.7435 


666X 


I 


SUBROUTINE 


5 


• EOF • 


SUM = 


124 
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The P=0 in the LIBEDIT statement indicates that no old program library exists. The 
N parameter indicates that the new program library is written on file TESTLIB. The 
replacement file is the default LGO. The directives are on the default INPUT file. 

LIBEDIT reads the binaries from LGO and the directives from INPUT. On the basis 
of the directive specifications, the binaries are inserted before the end-of-file on file 
TESTLIB in the order specified in the directives (A, B, C, D). The directory record 
created is given the name LIBRARY as a result of the *BUILD directive. It is written 
before the end-of-file on the new program library TESTLIB. 

The directives are written to OUTPUT. The records on file TESTLIB are listed on 
the next page of OUTPUT. The following listing consists of these two pages. 



LI3EDIT DIRECTIVE CARDS. 



79/03/01. 03.20.52. 



PAGE 



•BUILD LIBRARY 
























*B, «,SE 


;l/a,3,c 


,D 






















RECORDS WRITTEH ON 


FILE 


TESTLIB 






79/03/01. 


08.20. 


,52. 






PAGE 


2 


RECORD 


TYPE 




FILE 


DATE 


COMMENT 
















INSERTED A 


REL 




LGO 


79/03/01. 


OS. 16.29 


NOS 1.1 


FTN 


1. 


,7135 


656X 


I 


SUBR0UTINE0PT=1 


INSERTED 3 


REL 




LGO 


79/03/01. 


03.16.29 


SOS 1.1 


FTH 


1. 


.7135 


565X 


I 


SUBR0UTINE0PT=1 


INSERTED C 


REL 




LGO 


79/03/01. 


08.16.29 


NOS 1.1 


FTN 


1. 


,7135 


665X 


I 


SUBSOUTINEOfTsI 


IU3ERTED D 


REL 




LGO 


79/03/01. 


03.15.29 


NOS 1.1 


FTN 


1, 


,7»S5 


666X 


I 


SUBR0UTINE0PT=1 


ADDED LIBRARY 


OPLD 




«*»*» 


79/03/01. 


















■ Bgrjpit 



























The second CATALOG statement produces the following listing of information about the 
records on TESTLIB. 



re: 


CATALOG 
NAME 


OF TESTLIB 
TYPE 


FILE 
LENGTH 


1 
CKSUH 


DATE 


COMMENTS 


79/03/01 


. 08. 


21 


.15. 


PAGE 




1 


1 


A 
A 

B 

B 
C 

c 

D 

D 
LIBRARY 


REL 


23 


7517 


79/03/01. 


03.15.29 


HOS 1.1 


FTS 




1.7185 


666X 


I 


SUBROUTINE 


2 


REL 


25 


1110 


79/03/01. 


03.16.29 


SOS 1.1 


FTN 




1.7185 


666X 


I 


SUBROUTINE 


3 


REL 


25 


1150 


79/03/01. 


08.16.29 


SOS 1.1 


FTN 




1.7135 


666X 


I 


SUBROUTINE 


1 


REL 


25 


6705 


79/03/01. 


03.15.29 


NOS 1.1 


FTN 




1.7135 


666X 


I 


SUBROUTINE 


5 


OPLD 


13 


207 3 


79/03/01. 


















6 


• EOF • 


SUM = 


137 























Example 2! 

This job builds a new program library from an old program library by inserting new 
relocatable routines into and deleting routines from the old program library created 
in example 1 (TESTLIB). 
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LIBTES2. 

USER(EFD2S,PW) 

CHARGE(16,13N122) 

FTN(L=0) 

A TTACH(OLD=TESTLIB) 

DEFINE (NEW =TES2 LIB) 

LIBEDIT. 

CATALOG(NEW.R) 

-EOR- 

SUBROUTINE BONE 

STOP 

END 

SUBROUTINE D 

STOP 

END 

SUBROUTINE NEWC 

STOP 

END 
/EOR 

*TYPE REL 
*I, B, BONE 
*I,C,NEWC 
*D,C 
/EOF 

Three relocatable binaries (BONE, D, and NEWC) are produced via a FORTRAN 
Extended compilation. The old program library (TESTLIB) is attached in read mode 
and referenced as OLD. A direct access file (TES2LIB) is created for the new pro- 
gram library. This file is referenced as NEW. 



LIBEDIT reads the binaries from the replacement file LGO and the input directives 
from file INPUT. It writes the modified old program library (OLD) to the new pro- 
gram library (NEW). BONE and NEWC are inserted after records B and C, respec- 
tively, and record C is deleted. Record D, which already existed on the old program 



library, is replaced by record D from the replacement file LGO. 
is taken on file NEW. 



The following action 



LIBEDIT DIRECTIVE CARDS. 



79/03/01. 08.25.52. 



PAGE 



•TYPE 


: REL 
























•1,8, 


.BONE 
























•i,c, 


NEWC 
























»D,C 


























RECORDS WRITTEN OH 


FILE NEW 






79/03/01. 


08.25. 


,52. 




PACE 


2 


RECORD 


TYPE 


FILE 


DATE 


COMMENT 
















A 




REL 


OLD 


79/03/01. 


08.16.29 


NOS 


1.1 


FTN 


4.7435 


666X 


I 


SUBROUTINEOPTsI 


S 




REL 


OLD 


79/03/01. 


08. IS. 29 


NOS 


!."» 


FTN 


1.7435 


666X 


I 


SUBROUTINEOPTsI 


INSERTED BONE 
OELETED-(C) 




REL 

REL 


LGO 

OLD 


79/03/01. 


08.25.07 


NOS 


1.4 


FTN 


1.7435 


666X 


I 


SUBROUTINEOPTsI 


INSERTED NEWC 




REL 


LOO 


79/03/01. 


08.25.07 


NOS 


1.1 


FTN 


4.7485 


S66X 


I 


SUBROUTINEOPTsI 


REPLACED D 
ADDED LIBRARY 


REL 
OPLD 


LGO 


79/03/01. 
79/03/01. 


08.25.07 


NOS 


1.1 


FTN 


4.7435 


666X 


I 


SUBROUTINEOPTsI 


••EOF 


■#• 




OLD 
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The CATALOG shows the following contents of the new program library. 



c 


CATALOG 
NAME 


OF MEW 

TYPE 


FILE 
LENGTH 


1 
CKSUM 


DATE 


COMMENTS 


79/C 


13. 


'01 


. OS. 2 


6.1! 


i. 


PAGE 




1 


1 


A 


REL 


25 


75«7 


79/03/01. 


03.16.29 


NOS 


1, 


,11 


FTN 


1. 


,7135 


665X 


I 


SUBROUTINE 


2 


A 
B 

B 
SOME 

SOME 
KEWC 

NEWC 


D 
LIBRARY 


REL 


25 


1110 


79/03/01. 


08.16.29 


■JOS 


1, 


,i 


FTN 


i. 


,7135 


S66X 


I 


SUBROUTINE 


3 
1 
5 


REL 
BEL 
SEL 


25 

25 
25 


1103 
0371 
6705 


79/03/01. 
79/03/01. 
79/03/01. 


08.25.07 
08.25.07 
08.25.07 


SOS 
NOS' 
NOS 


1, 
1, 
1, 


,1 
.1) 


FTN 
FTN 
FTN 


i. 
1. 
1. 


,7135 
,7135 
,7135 


666X 
666X 
566X 


I 
I 


SUBROUTINE 
SUBROUTINE 
SUBROUTINE 


6 


OPLD 


15 


1312 


79/03/01. 






















7 


« EOF * 


SUM = 


166 



























Example 3"> 

This job uses LIBGEN to generate a user library file from the program library file 
TES2LIB created in example 2. 

LIBTES3. 

USER(EFD25) 

CHARGE(16, 13N122) . 

ATTACH(TES2LIB) 

DEFESTE(LIBLOAD) 

LIBGEN(F =TES2LIB, P =LIBLOA D, N=LOA DLIB) 

CA TA LOG(LIBLOA D, R , U) 

-EOF- 



The program library TES2LIB is attached to the job. 
is defined for writing the user library file. 



A direct access file LIBLOAD 



LIBGEN scans TES2LIB and builds a ULIB directory of entry points, program names, 
and external references for relocatable (REL) records in the file. ULIB is copied to 
the file LIBLOAD, followed by the records from TES2LIB. A file index of addresses 
for each record in the file is added as the last record of LIBLOAD. LOADLIB is 
the name of the ULIB and OPLD records. 

The CATALOG of the user library file LIBLOAD shows the following content. 



:c 


CATALOG 
NAME 


OF LIBLOAD 
TYPE 


LEW 


FILE 

GTH 


1 
CKSUM 


DATE 


COMMENTS 


79/03/01 


. 03.29 


.02. 


PAGE 




1 


1 

2 


LOADLIB 
A 


ULIB 
REL 




13 


1267 

TT NT 

1 J1 1 


79/03/01. 
79/03/01. 


03.15.29 


NOS 1.1 


FTN 


1.7135 


56 5X 


I 


SUBROUTINE 


3 


S 
3 


REL 




25 


1110 


79/03/01. 


OS. 15.29 


NOS 1 . 1 


FTN 


1.7135 


666X 


I 


SUBROUTINE 


1 


SOME 
BONE 


REL 




25 


1103 


79/03/01. 


OS. 25. 07 


SOS 1.1 


FTN 


1.7135 


666X 


I 


SUBROUTINE 

« 


5 


NEWC 
NEWC 


REL 




25 


0371 


79/03/01. 


03.25.07 


NOS 1.1 


FTN 


1.7135 


666X 


I 


SU3R0UTIHE 


6 


D 
D 


REL 




25 


6705 


79/03/01. 


. 08.25.07 


M0S 1 . 1 


FTN 


1.7135 


66SX 


I 


SUBROUTINE 


7 


LOADLIB 


OPLD 




13 


6303 


79/03/01. 
















3 


« EOF « 


SUM = 




201 
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Example 4: 

This job illustrates a method for deleting records from a user library. GTE removes 
the relocatable records (REL) from the user library, LIBEDIT makes the desired 
changes, and LIBGEN generates a new user library. 

LIBTES4. 

USER(EFD25,PW) 

CHARGE(16,13N122) 

A TTA CH(LIBLOA D /M =W) 

GTR(LIBLOAD,OLD)REL/* 

LIBEDIT. 

LIBGEN(F=NEW,P=LIBLOAD,N=LOADLIB) 

CATA LOG(LIBLOAD, R, U) 

-EOR- 

*D,REL/NEWC 

-EOF- 

The user library generated in example 4 (LIBLOAD) is attached to the job's control 
point. 

Because LIBEDIT handles a user library as a single record, the GTR statement must 
be used to extract the relocatable records from LIBLOAD and write them on the file 
OLD. (This control statement terminates after OLD; the REL/* is a directive speci- 
fying all relocatable records.) 

LIBEDIT references the program library OLD and the directive record, deletes NEWC, 
and writes this modified file on the default NEW. The following is a listing of NEW. 



LIBEDIT DIRECTIVE CARDS. 
•D.REL/NEWC 



79/03/01. 08.30.05. 



RECORDS WRITTEN ON FILE NEW 

RECORD TTPE FILE 

REL OLD 

REL OLD 

REL OLD 

REL OLD 

REL OL0 
OLD 



A 
3 

SONE 
DELETED-(NEWC) 
D 
"EOF" 



DATE 
79/03/01. 
79/03/01. 
79/03/01. 



COMMENT 
08.15.29 
03.16.29 
08.25.07 



79/03/01. 08.30.06. 



NOS 1.4 
MOS 1.1 
N0S 1.4 



FTN 
FTN 
FTN 



PAGE 



PAGE 



1.7135 666X I 
1.7135 666X I 
4.7135 665X I 



79/03/01. 08.25.07 NOS 1.4 FTN 4.7435 666X I 



SUBR0UTINE0PT=1 
SUBR0UTINE0PT=1 
SUBRClUTINEOPTsI 

SUBROUTINEOPTsI 



LIBGEN generates a new user library on the file LIBLOAD. It uses NEW as the 
source and names the new user library LIBLOAD. 

The user library is cataloged, showing the following contents. 



:c 


CATALOG i 
NAME 


JF LI 31 
TTPE 


.OAD 


FILE 
LENGTH 


1 


DATE 


COMMENTS 


79/03/01 


. 03. 


30 


.54. 


PAGE 




1 


i 

2 


L0ADLIB 
A 

A 


ULIB 

SEL 




11 
25 


1055 
7517 


79/03/01. 
79/03/01. 


03.15.29 


NOS 1.4 


FTN 




4.7435 


666X 


I 


SUBROUTINE 


3 


8 
3 


SEL 




25 


1410 


79/03/01. 


03.15.29 


NOS 1.4 


FTN 




'1.7435 


566X 


I 


SUBROUTINE 


4 


3 ONE 
BONE 


SEL 




25 


1103 


79/03/01. 


03.25.07 


NOS 1 . 4 


FTN 




4.7435 


666X 


I 


SUBROUTINE 


5 







SEL 




25 


6705 


79/03/01. 


03.25.07 


NOS 1 . 4 


CTpj 




».7435 


666X 


T 


SUBROUTINE 


6 


LOADLia 


0PLD 




13 


3414 


79/03/01. 
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CHARACTER SETS 



A character set is composed of graphic and /or control characters. A code set is a 
set of codes used to represent each character within a character set. 

A graphic character may be displayed at a terminal or printed by a line printer. 
Examples are the characters A through Z and the digits 1 through 9. A control 
character initiates, modifies, or stops a control operation. An example is the back- 
space character that moves the terminal carriage or cursor back one space. Although 
a control character is not a graphic character, a terminal may produce a graphic 
representation when it receives a control character. 

All references within this manual to the ASCII character set or the ASCII code set 
refer to the character set and code set defined in the American National Standard 
Code for Information Interchange (ASCII, ANSI Standard X3. 4-1977). References in 
this manual to the ASCII character set do not necessarily refer to the ASCII code 
set. 

NOS supports the following character sets. 

• CDC graphic 64- (or 63-) character set 

• ASCII 128-character set 

« ASCII graphic 64- (or 63-) character set 

s ASCII graphic 95-character set 

Each installation selects either the 64-character set or the 63 -character set. The 
differences between the two are described in Character Set Anomalies in this appendix. 
Any reference in this appendix to the 64~character set implies either the 63- or 64- 
character set unless otherwise stated. 

NOS supports the following code sets. 

• Display code 

• 6/12 display code 

• 12 -bit A SCn code 

Display code is a set of 6-bit codes from 00 8 to 77 8 . 

The 6/12 display code is a combination of 6-bit codes and 12 -bit codes. The 6-bit 
codes are 00 8 through 773, excluding 74 8 and 76s. (Refer to Character Set Anormalies 
for the interpretation of the 00 8 and 63 8 codes.) The 12-bit codes begin with either 
74 8 or 76o and are followed by a 6-bit code. Thus, 74o and 76 8 are considered 
escape codes and are never used as 6-bit codes within the 6/12 display code set. 
The 12-bit codes are 740l 8 , 7402n, 7404 8 , 7407 a , and 7601 8 through 7677 8 . All 
other 12 -bit codes (74xx 8 and 7600 8 ) are undefined. 
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Sht-L^i^i? i^ wt hS. AS ? ? ' bit CO *f (a f d ^ ed by ANSI Standard X3.4-1977) 
rignt-justified in a 12 -bit byte. Assuming that the bits are numbered from the ri»ht 

startmg with bits through 6 contain the ASCII code, bitsTSg ^1? carta? 

Tt? 5 ,*, wt hl \ " dMrt !5Si ish t B *• 12 " bit ASCn 0000 8 ^e from thVend-of-Se Me. 
The 12-bit codes are 0001 8 through 0177 8 and 4000 8 . ^ 

CHARACTER SET ANOMALIES 

NOS interprets two codes differently when the installation selects the 63-character 
set rather than the 64-character set. In tables 1-A-l, l-A-2, an 1 l-A-3, t?e codes 
f& SSJ^ £ d Pe f Cent I raphiC characte ^ in the 64:character set are uJXdedT 
shaded! C PerCent graphiC charact ers in the 63-character set are 

If an installation uses the 63-character set, the colon graphic character is always 
represented by a 63 8 code. However, if the installation uses the 64-character set 
23? °L 6 rL U di T 1 ^ codes , 7404 8 or 00 8 produces a colon £ A8CT «SJSj£ 
mode, colon can be input only as a 7404 8 6/12 display code. snaruig 

SS fl^^fli ^ 63 ; ° r 64 " cha f acter set. the use of undefined 6/12 display 
codes in output files produces unpredictable results and should be avoided. 

fi 3 ^^ °° 8 a 06 ^ fay be confused with an end-of-line byte and should "be avoided 
(refer to appendix F for further explanation). »»*«"." u<* dVOlQeQ 

CHARACTER SET TABLES 

This appendix contains character set tables for time-sharing users, batch users and 
magnetic tape users. Table 1-A-l is for time-sharing usefs? and table l-A -fig 
4 °£n b T atC V 3er3 J J &ble 1_A - 3 ** a conversion table used to crSs-reference 12-bit 
decimal 3 /12 diSplay °° deS aad t0 COnvert ASCn codes f«m octal to hexa- 

Tables l-A-4 and l-A-5 list the magnetic tape codes and their display code equivalents. 

J^J?t raCter i et / tab l. e8 are desi K ned so that the user can find the character repre- 

To find L SS, P ( Kf b aS m I d ^ p) ° r find the code that represents a character. 
Si£ ^ character represented by a code, the user looks up the code in the column 

1XE5 h! f Pr ° Prla 8 C v de 3et and then finds the character on that line in the colZi 
listing the appropriate character set. To find the code that represents a character 

Sriat7col°uSn. UP ** '*"**** "* thaB ^ the COde on ih < ^STSe in° th^ro- 

TIME-SHARING USERS 

ml!X ,«- _1 S ^ WS - h \™ ra f ter sets and code sets available to an ASCII code ter- 
minal user. When in NORMAL time-sharing mode (specified by the NORMAL time- 

alf r inout C anTo^ *t l™**?^* ^ A £CII i-phic ^-character set anTJoferpr^ 
Si Wtt^- UtP u Ut f a dlsplay code " When in Ascn time-sharing mode (specified by 
«f™? a tune-sharing command). NOS displays the ASCII 128-character stf and * 
interprets all input and output as 6/12 display code. 
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The time-sharing user can convert a 6/12 display code file to a 12 -bit ASCII code file 
using the FCOPY control statement (section 7). The resulting 12-bit ASCII file can 
be routed to a line printer (refer to the ROUTE statement in section 7) but cannot 
be output at a time-sharing terminal. 

To determine the octal or hexadecimal ASCII code for a character, refer to table 
l-A-3. (Certain terminal definition commands require specification of an ASCII 
code. ) 

BATCH USERS 

Table l-A-2 lists the CDC graphic 64-character set, the ASCII graphic 64-character 
set, and the ASCII graphic S5-character sets. It also lists the code sets and card 
punch codes (026 and 029) that represent the characters. 

H ie u-? 4 ;^f£ act, f sets use dis P la y code as th « ir code set; the 95-character set uses 
\i~J?„ A _ S CII code « The 95-character set is composed of all the characters in the 
ASCII 128-charaeter set that can be printed at a line printer (refer to Line Printer 
Usage). Only 12-bit ASCII code files can be printed using the ASCII graphic 95- 
character set. To print a 6/12 display code file (usually created in time-sharine 
ASCII mode), the user must convert the file to 12-bit ASCII code. To do this he 
issues the FCOPY control statement (section 7). The 95-character set is represented 
by 12-bit. ASCII codes 0040 8 through 0176 8 . 

LINE PRINTER USAGE 

The batch character set printed depends on the print train used on the line printer 
to which the file is sent (refer to the ROUTE control statement in section 7). The 
following are the print trains corresponding to each -of the batch character sets. 

Character Sej Print Train 

CDC graphic 64-character set 596-1 

ASCII graphic 64-character set 596-5 

ASCII graphic 95-character set 596-6 

^IViT™ 6 ^ 8 of J he defau " 596-1 print train are listed in the table l-A-2 column 

taSlil ? D 2 C J2 ,BphiC i I 64 , ?T2U the 596 " 5 P rint train characters are listed in FhT 
table l-A-2 column labeled ASCII Graphic (64 Char); and the 596-6 print train char- 
acters are listed in the table l-A-2 column labeled ASCII Graphic (95 Char?. 

%hl ™ smis3 i on er F° r Qccurs when Printing a line, the system prints the line aeain 
The CDC graphic print train prints a concatenation symbol V) in the first Stable^* 
column of a line containing errors. The ASCII print trains print a* underline < '* 
instead of the concatenation symbol. uraerune i_, 

w'SKoftonSrS?^ 6 ^ tS to u lhle ifb ?\ iS * a 12 " bit ASCU code outsid * the 
3Tor£t fin. ^2?. J $8) : the , n ? unbe ^ si e n W a PP^rs in the first printable column 
oi a print line, and a space replaces the unprintable character. 
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TABLE 1-A-l. TIME-SHARING CHARACTER SETS 























ASCII 


ASCII 




6/12 


12-Bit 


ASCII 


ASCII 




6/12 


12-Bit 


Graphic 


Character 


Display 


Display 


ASCII 


Graphic 


Character 


Display 


Display 


ASCII 


(64 Cher) 


(128 Char) 


Code 


Code 


Code 


(64 Char) 


(128 Char) 


Code 


Code 


Code 


: colon t 




oof 






tt ma. sign 


ft mm. sign 


60 


60 


0043 


■ :., M. « u ■.. ■- - n.i '-. ■- 


I* 1. bracket 


C I. bracket 


61 


61 


0133 


I l3*c , »*)»w«v +e*s* - . „ . 


IMP 


: ;-.v::X':: ; :v:;?:->:;>;; : :;;- 




3 t. bracket 


3 r. bracket 


62 


62 


0135 


A 


A 


ot 


01 


0101 


Xt 


.?!..>. 


63t 


63T 


0045 


8 


B 


02 


02 


0102 


tf&fe&U 


^^fflSwK^^^^ 


mmmfimmffltimmft 


C 


C 


03 


03 , 


0103 


" quote 


" quote 


64 


64 


0042 





6 


04 


04 


0104 


underline 


underline 


65 


65 


0137 


E 


E 


05 


05 


0105 


T 


T 


66 


66 


0041 


T 


r 


06 


06 


0106 


ft aapersand 


( anpersand 


67 


67 


0046 


6 


6 


07 


07 


0107 






















' apostrophe 


* apostrophe 


70 


70 


0047 












* 


•> 


71 


71 


0077 


H 


H 


10 


10 


0110 


< 


< 


72 


72 


0074 


I 


I 


11 


il 


0111 


> 


> 


73 


73 


0076 


J 


J 


12 


12 


0112 


8 




74 






K 


K 


13 


13 


0113 


\ rev, slant 


\ rev. slant 


75 


75 


0134 


t 


I 


14 


14 


0114 


* circumflex 




76 






It 


n 


IS 


15 


0115 


; scaieolon 


; aeaicolon 


77 


77 


0073 


N 


N 


16 


16 


0116 


















17 


17 


0117 




8 

* circmflex 




7401 
7402 


tjioo 

0136 


P 
9 


9 

• 


20 

21 


20 
21 


0120 
0121 




: colon t 




7404t 

""7407 


0072 
0140 


grave accent 




8 


R 


22 


22 


0122 












S 


S 


23 


23 


0123 




a 




7601 


0141 


T 


T 


24 


24 


0124 




b 




7602 


0142 


U 


U 


25 


25 


0125 




c 




7603 


0143 


¥ 


V 


26 


26 


0126 




d 




7604 


0144 


U 


V 


27 


27 


0127 




e 
f 




7605 
7606 


0145 
0146 


X 


X 


30 


30 


0130 




9 




7607 


0147 


V 


y 


31 


31 


0131 












Z 


z 


32 


32 


0132 




h 




7610 


0150 








33 


33 


0060 




1 




7611 


0151 


1 


1 


34 


34 


0061 




J 




7612 


0152 


2 


2 


35 


35 


0062 




k 




7613 


0153 


3 


3 


36 


36 


0063 




I 




7614 


0154 


4 


4 


37 


37 


0064 




n 





7615 
7616 
7617 


0155 
0156 
0157 


5 


,5 


40 


40 


0065 












6 


6 


41 


41 


0066 




p 




7620 


0160 


7 


7 


42 


42 


0067 




q 




7621 


0161 


8 


8 


43 


43 


0070 




r 




7622 


0162 


9 


9 


44 


44 


0071 




s 




7623 


0163 


* 


♦ 


45 


45 


0053 




t 




7624 


0164 


- 


- 


46 


46 


0055 




u 




7625 


0165 


* 


* 


47 


47 


0052 




V 

II 




7626 
7627 


0166 
0167 


1 


/ 


50 


50 


0057 




X 




7630 


0170 


( 


£ 


51 


51 


0050 




y 




7631 


0171 


) 


) 


52 


52 


0051 




z 




7632 


0172 


$ 


5 


53 


53 


0044 




■C left brace 




7633 


0173 


a 


s 


54 


54 


0075 




| vert, line 




7634 


0174 


• pace 


space 


55 


55 


0040 




> right brace 




7635 


0175 


s COHSD 5 


^ coswa 


56 


56 


0054 




- tilde 




7636 


0176 


. period . period 


57 


57 


0056 




DEL 




7637 


0177 


tihe interpretation of thi» 


charactei 


* or code 


depends 


on its context. Refer to Cha 


raccer S« 


t Anomalies 


in this »pp( 


endix. 



















79AAIA 
i OF Z 






• l-A-4 



604 35400 J 



TABLE 1-A-l. TIME-SHARING CHARACTER SETS 



ASCII 


ASCII 




6/12 


12-Bit 


ASCII 


ASCII 




6/12' 


12-Bit 


Graphic 


Character 


Display 


Display 


ASCII 


Graphic 


Character 


Display 


Display 


ASCII 


(64 Char) 


(128 Char) 


Code 


Code 


Code 


(64 Char) 


(128 Char) 


Code 


Code 


Code 




KUL 




7640 


4000 




DLE 




7660 


0020 




SOU 




7641 


0001 




DC1 




7661 


0021 




STX 




7642 


0002 




DC2 




7662 


0022 


* 


ETX 




7643 


0003 




DC3 




7663 


0023 




EOT 




7644' 


0004 




DC4 




7664 


0024 




ESQ 




7645 


0005 




NAK 




7665 


0025 




ACK 




7646 


0006 




SYH 




7666 


0026 




BEL 




7647 


0007 




ETB 




7667 


0027 




SS 




7650 


0010 




CAH 




7670 


0030 




HT 




7651 


oon 




EM 




7671 


0031 




LF 




7652 


0012 




SUB 




7672 


0032 




VT 




7653 


00.13 




ESC 




7673 


0033 




FF 




7654 


0014 




FS 




7674 


0034 




CR 




7655 


0015 




GS 




7675 


0035 




SO 




7656 


0016 




RS 




7676 


0036 




SI 




7657 


0017 




OS 




7677 


0037 
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TABLE l-A-2. BATCH CHARACTER SETS 



V 



£DC 

Graphic 

(64 Char) 


ASCII 

Graphic 

(64 Char) 


ASCII 
Graphic . 
(95 Char) 


Display 
Code 


6/12 

Display 

Code 


12-Bit 
ASCII 
Code 


Punch 


Code 


026 


029 


: colont 


: colon t 




. 00 1 






8-2 


8-2 


0i#fi«jr«O^ W *& aa-Htiteii m stt*a tt*£ag U» $3~<*««cfc?r 


set. 




A 


A 


A 


01 


01 


0101 


12-1 


12-1 ' 


B 


8 


8 


02 


02 


0102 


12-2 


12-2 


C 


C 


C 


03 


03 


0103 


12-3 


12-3 


D 








04 


04 


0104 


12-4 


12-4 


E 


E 


1 


05 


05 


0105 


12-5 


12-5 


F 


F 


f 


06 


06 


0106 


12-6 


12-6 


G 


G 


G 


07 


07 


0107 


12-7 


12-7 


H 


H 


H 


10 


10 


0110 


12-8 


32-8 


I 


I 


I 


11 


11 


0111 


12-9 


12-9 


J 


J 


J 


12 


12 


0112 


11-1 


11-1 


K 


K 


K 


13 


13 


0113 


11-2 


11-2 


L 


L 


U 


14 


14 


0114 


11-3 


11-3 


M 


N 


H 


15 


15 


0115 


11-4 


11-4 


N 


H 


N 


16 


16 


0116 


11-5 


11-5 











17 


17 


0117 


11-6 


11-6 


P 


P 


P 


20 


20 


0120 


11-7 


11-7 


Q 


Q 


Q 


21 


21 


0121 


11-8 


11-8 


ft 


R 


R 


22 


22 


0122 


11-9 


11-9 


S 


S 


S 


23 


23 


0123- 


0-2 


0-2 


T 


T 


T 


24 


24 


0124 


0-3 


0-3 


U 


U 


U 


25 


25 


0125 


0-4 


0-4 


V 


V 


V 


26 


26 


0126 


0-5 


0-5 


W 


w 


W 


27 


27 - 


0127 


0-6 


0-6 


X 


X 


X 


30 


30 


0130 


0-7 


0-7 


y 


Y 


Y 


31 


31 


0131 


0-8 


0-8 


z 


z 


Z 


32 


32 


0132 


0-9 


0-9 











33 


33 


0060 








1 


1 


1 


34 


34 


0061 


1 


1 


2 


2 


2 


35 


35 


0062 


2 


2 


3 


3 


3 


36 


36 


0063 


3 


3 


4 


4 


4 


37 


37 


0064 


4 


4 


5 


5 


5 


40 


40 


0065 


5 


5 


6 


6 


6 


41 


41 


0066 


6 


6 


7 


7 


7 • 


42 


42 


0067 


7 


7 


8 


8 


8 


43 


43 


0070 


8 


8 


9 


9 


9 


44 


44 


0071 


9 


9 


+ 


-r 


T 


45 


45 


0053 


1 11 

1 d. 


12-8-6 


- 


- 


- 


46 


46 


0055 


11 


11 


* 


* 


* 


47 


47 


0052 


11-8-4 


11-8-4 


t The interp 


recation of this character or code depends on its 


context . 


Refer to 




Character 


Set Anomalies 


in this appendi 


X. 
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TABUE l-A-2. • BATCH CHARACTER SETS 



CDC 


ASCII 


ASCII 




6/12 


12-Bit 


Punch 


Code 


Graphic 
(64 Char) 


Graphic 
(64 Char) 


Graphic 
(95 Char) 


Display 
Code 


Display 
Code 


ASCII 






Code 


026 


029 


/ 


/ 


/ 


50 


50 


0057 


0-1 


0-1 


( 


( 


( 


51 


51 


0050 


0-8-4 


12-8-5 


) 


3 


) 


52 


52 


0051 


12-8-4 


11-8-5 


$ 


S 


S 


53 


53 


0044 


11-8-3 


11-8-3 


a 


= 


X 


54 


54 


0075 


8-3 


8-6 


space 


epace 


space 


55 


55 


0040 


no punch 


no punch 


f conraa 


, comma 


, comma 


56 


56 


0054 


0-8-3 


0-8-3 


. period 


. period 


. period 


57 


57 


0056 


12-8-3 


12-8-3 


£ equiv. 


# num. sign 


# num. sign 


60 


60 


0043 


0-8-6 


8-3 


C 1 . bracket 


C 1. bracket 


[ 1. bracket 


61 


61 


0133 


8-7 


12-8-2 


3 r. bracket 


3 r. bracket 


3 r. bracket 


62 


62 


0135 


0-8-2 


11-8-2 


% t 


..?,!.,„,,,„.....,,.,,,« 


% t 


63 1 


63 T 


0045 


8-6 


0-8-4 


: colcm 


.:. colon, Wij 




Iliitii 


; . : :. :.'.■. «3--: ' 


iliiilii 


8-3 


HI 


* 


" quote 


" quote 


64 


64 


0042 


8-4 


8-7 


t* 


underline 


__ underline 


65 


65 


0137 


0-8-5 


0-8-5 


V 


T 


T 


66 


66 


0041 


11-0 


12-8-7 


A 


8 ampersand 


& ampersand 


67 


67 


0046 


0-8-7 


12 


t 


' apostrophe 


1 apostrophe 


70 


70 


0047 


11-8-5 


8-5 


4 


•> 


1 


71 


71 


0077 


11-8-6 


0-8-7 


< 


< 


< 


72 


72 


0074 


12-0 


12-8-4 


> 


> 


> 


73 


73 


0076 


11-8-7 


0-8-6 


£ 


3 




74 






8-5 


8-4 


1 


V rev, slant 


\ rev. slant 


75 


75 


0134 


12-8-5 


0-8-2 


n 


" circumflex 




76 






12-8-6 


11-8-7 


; semicolon 


; semicolon 


; serai co Ion 

a 

* circumflex 
: colon t 


77 


77 

7401 
7402 
7404 1 


0073 

0100 

' 0136 

0072 


12-8-7 


11-8-6 




:::K:':;:::^xS:^y?::!W:^S : :vX : : : : 


grave accent 

a 
b 
c 
d 
e 
f 




f&0** 
7407 

7601 
7602 
7603 
7604 
7605 
7606 


:ttQ045\ ; ' : 
0140 

0141 
0142 
0143 
0144 
0145 
0146 


SISsbIk? 


• 






9 




7607 


0147 






t The interpretation of th 


is character or 


code dep 


ends on its 


context. 


Refer to 




Character 


Set Anomalies 


in this append 


IX. 
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TABLE l-A-2.- BATCH CHARACTER SETS 



• CDC 


ASCII 


ASCII 




6/12 


12-Bit 


Punch Code 


Graphic 
(64 Char) 


Graphic 
(64 Char) 


Graphic 
(95 Char) 


Display 
Code 


Display 
Code 


ASCII 




Code 


026 


029 






h 




7610 


0150 










i 




7611 


0151 










j 




7612 


0152 










k 




7613 


0153 










L 




7614 


0154 










ID 




7615 


0155 










n 




7616 


0156 















7617 


0157 










P 




7620 


0160 










q 




7621 


0161 










r 




7622 


0162 










s 




7623 


0163 










t 




7624 


0164 










u 




7625 


0165 










V 




7626 


0166 










w 




7627 


0167 










% 




7630 


0170 










y 




7631 


0171 










z 




7632 


0172 










< left brace 




7633 


0173 










| vert, line 




7634 


0174 










> right brace 




7635 


0175 










" tilde 




7636 


0176 
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TABLE i- 


A-3. ASCII TO 6 


/12 DISPLAY CODE CONVE! 


IS ION 






ASCII 
Character 
(128 Char) 


12-Bit 
ASCII Code 


6/12 

Display 

Code 


ASCII 
Character 
(128 Char) 


12-Bit 
ASCII Code 


6/12 

Display 

Code 


Octal 


Hex 


Octal 


Hex 


! NUL 


4000 


00 


7640 





0060 


30 


33 


SOB 


0001 


01 


7641 


1 


0061 


31 


34 


STX 


0002 


02 


7642 


2 


0062 


32 


35 


ETX 


0003 


03 


7643 


3 


0063 


33 


36 


EOT 


0004 


04 


7644 


4 


0064 


34 


37 


ESQ 


0005 


05 


7645 


5 


0065 


35 


40 


ACK 


0006 


06 


7646 


6 


0066 


36 


41 


BEL 


0007 


07 


7647 


7 


0067 


37 


42 


BS 


0010 


08 


7650 


8 


0070 


38 


43 


HT 


0011 


09 


7651 


9 


0071 


39 


44 


LF 


0012 


0A 


7652 


: colon t 


0072 


3A 


7404 1 


VT 


0013 


0B 


7653 


..«*.«' 


<gm * 


■1 


*3 


TV 


0014 


OC 


7654 


; semicolon 


0073 


3B 


77 


CR 


0015 


0B 


7655 


< 


0074 


3C 


72 


SO 


0016 


OE 


7656 


s 


0075 


3D 


54 


SI 


0017 


OF 


7657 


> 


0076 


3E 


73 










•> 


0077 


3F 


71 


DIE 


0020 


ID 


76*0 










DC1 


0021 


11 


7661 | 


a 


0100 


40 


7401 


DC2 


0022 


12 


7662 


A 


0101 


41 


01 


DC3 


0023 


13 


7663 


6 


0102 


42 


02 


DC4 


0024 


14 


7664 


C 


0103 


43 


03 


KAK 


0025 


15 


7665 


t> 


0104 


44 


04 


SYN 


0026 


16 


7666 


E 


0105 


45 


05 


ETB 


0027 


17 


7667 


r 


0106 


46 


06 










G 


0107 


47 


07 


CAN 


O030 


18 


7670 










EH 


0031 


19 


7671 


« 


0110 


48 


10 


SOB 


0032 


1A 


7672 


I 


0111 


49 


11 


ESC 


0033 


IB 


7673 


J 


0112 


4A 


12 


FS 


0034 


1C 


7674 


K 


0113 


4B 


13 


CS 


0035 


ID 


7675 


L 


0116 


4C 


14 


RS 


0036 


IE 


7676 


M 


0115 


4D 


15 


as 


0037 


IF 


7677 


H 


0116 


4E 


16 













0117 


4F 


17 


space 


0040 


20 


55 










i 


0041 


21 


66 


P 


0120 


50 


20 


" quote 


0042 


22 


64 


a 


0121 


51 


21 


H number sign 


0043 


23 


60 


R 


0122 


52 


22 


S 


0044 


24 


53 


S 


0123 


53 


23 


It. 


0045 


25 


63 1 


T 


0124 


54 


24 




Ipftsf! 


mi 


W*„ > 


U. 


0125 


55 


25 


i ampersand 


" mC 


26 


67 


V 


0126 


56 


26 


' apostrophe 


0047 


27 


70 


w 


0127 


57 


27 


C 


0050 


28 


51 


X 


0130 


58 


30 


> 


0051 


29 


52 


Y 


0131 


59 


31 


* 


0052 


2A 


47 


z 


0132 


5A 


32 


+ 


0053 


2B 


45 


t left bracket 


0133 


5B 


61 


/ cotoma 


0054 


2C 


56 


\ reverse slant 


0134 


5C 


75 


- 


0055 


2D 


46 


3 right bracket 


0135 


5D 


62 ! 


. period 


0056 


2E 


57 


circumflex 


0136 


5E 


7402 ! 


/ 


0057 


2F 


50 


underline 


0137 


5F 


65 


t The interpretation 


of this character or code to* 


f depend on its context 


. Refer to C 


lisracter Set 


Anomalies elsewher 


e in th 


is app 


sndix. 
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TABLE l-A-3. ASCII TO 6/12 DISPLAY CODE CONVERSION 



ASCII 
Character 
(128 Char) 


12-Bit 

ASCII Code 


6/12 

Display 

Code 


ASCII 
Character 
(128 Char) 


12-Bit 
ASCII Code 


6/12 

Display 

Code 


Octal 


Hex 


Octal 


Hex 




grave accent 


0140 


60 


7407 


P 


0160 


70 


7620 


a 




0141 


61 


7601 


<i 


0161 


71 


7621 


b 




01*2 


62 


7602 


r 


0162 


72 


7622 


c 




0143 


63 


7603 


s 


0163 


73 


7623 


d 




0144 


64 


7604 


t 


0164 


74 


7624 


e 




0145 


65 


7605 


u 


0165 


75 


7625 


f 




0146 


66 


7606 


V 


0166 


76 


7626 


9 




0147 


67 


7607 


w 


0167 


77 


7627 


h 




0150 


68 


7610 


X 


0170 


78 


7630 


i 




0151 


69 


7611 


y 


0171 


79 


7631 


i 




0152 


6A 


7612 


z 


0172 


7A 


7632 


k 




0153 


63 


7613 


< left brace 


0173 


7B 


7633 


L 




0154 


6C 


7614 


1 vertical line 


0174 


7C 


7634 


m 




0155 


6D 


7615 


> right brace 


0175 


7D 


7635 


n 




0156 


6E 


7616 


" tilde 


0176 


7E 


7636 







0157 


6F 


7617 

.-,,„ ■-,:■, ,„.,„l 


MX 


0177 


7F 


7637 
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Coded data to be copied from mass storage to magnetic tape is assumed to be represented in display code. 
NOS converts the data to external BCD code when writing a coded 7-track tape and to ASCII or EBCDIC code 
(as specified on the tape assignment statement) when writing a coded 9-track tape. 

Because only 63 characters can be represented in 7-track even parity, one of the 64 display codes is lost in 
conversion to and from external BCD code. The following shows the differences in conversion depending on 
the character set (63 or 64) which the system uses. 







63-Character Set 


Display Code 




External BCD 


00 




18 


33 


Output 

■ ■ p 


12 


63 




12 

64-Character Set 


Display Code 




External BCD 


00 




12 


33 


Output 


12 


63 




16 



Input 



Input 



Display Code 
00 
33 
33 

Display Code 
33 
33 
63 



« f ti°f 8I ? aS6 ^, SCU ° r EBCDIC code is read from a 9-track coded tape, it is converted to its uppercase 
6 -bit display code equivalent. To read and write lowercase ASCII or EBCDIC characters, the user must 
assign the tape in binary mode and perform his own conversion of the binary data. 



Table l-A-4 lists the uppercase character codes and their display code equivalents. 
display code equivalents for lowercase character codes read. 



Table l-A-5 lists the 



* 
,.-'* 



l-A-10 
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TABLE l-A-4. CODED TAPE CONVERSION (UPPERCASE CHARACTERS ONLY) 





7 -Track 






7-Track 








Tapes 


9-Track Tapes 




Tapes 


9~Tr»ck Tapes 


Display 






Display 




















Code 


External 






Code 


External 






(Octal) 


BCD 


ASCII 


EBCDIC 


(Octal) 


BCD 


ASCII 


EBCDIC 


00 


121 


072 


172 


40 


05 


065 


365 


01 


61 


101 


301 


41 


06 


066 


366 


02 


62 


102 


302 


42 


07 


067 


367 


03 


63 


103 


303 


43 


10 


070 


370 


04 


64 


104 


304 


44 


11 


071 


371 


05 


65 


105 


305 


45 


60 


053 


116 


06 


66 


106 


306 


46 


40 


055 


140 


07 


67 


107 


307 


47 


54 


052 


134 


10 


70 


110 


310 


50 


21 


057 


141 


a 


71 


111 


311 


51 


34 


050 


115 


12 


41 


112 


321 


52 


74 


051 


135 


13 


42 


113 


322 


53 


53 


044 


133 


14 


43 


114 


323 


54 


13 


075 


176 


15 


44 


115 


324 


55 


20 


040 


100 


16 


45 


116 


325 


56 


33 


054 


153 


17 


46 


117 


326 


57 


73 


056 


113 


20 


- 47 


120 


327 


60 


36 


043 


173 


21 


50 


121 


330 


61 


17 


133 


112 


22 


51 


122 


331 


62 


32 


135 


132 


23 


22 


123 


342 


63 


16 1 


045 


154 


24 


23 


124 


-343 


64 


14 


042 


177 


25 


24 


125 


344 


65 


35 


137 


155 


26 


25 


126 


345 


66 


52 


041 


117 


27 


26 


127 


346 


67 


37 


046 


120 


30 


27 


130 


347 


70 


55 


047 


175 


31 


30 


131 


350 


71 


56 


077 


157 


32 


31 


132 


351 


72 


72 


074 


114 


33 


12 1 


060 


360 


73 


57 


076 


156 


34 


01 


061 


361 


74 


15 


100 


174 


35 


02 


062 


362 


75 


75 


134 


340 


36 


03 


063 


363 


76 


76 


136 


137 


37 


04 


064 


364 


77 


77 


073 


136 


tAs explained previously in this section, conve 


rsioa of then 


i codes depends 


on whether 


the tape 


i» being read or written. 
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TABLE l-A-5. LOWERCASE CHARACTER COHVER.SION FOR READING 9-TRACK CODED TAPES 



Display 


9-Track Tapes 


Display 


9-Track Tapes 










Code 


ASCII 


EBCDIC 


Code 


ASCII 


EBCDIC 


00 


032 


077 


40 


025 


075 


01 


141 


201 


41 


026 


062 


02 


142 


202 


42 


027 


046 


03 


143 


203 


43 


030 


030 


04 


144 


204 


44 


031 


031 


05 


145 


205 


45 


013 


013 


06 


146 


206 


46 


015 


015 


07 


147 


207 


47 


012 


045 


10 


150 


210 


50 


017 


017 


11 


151 


211 


51 


010 


026 


12 


152 


221 


52 


Oil 


005 


13 


153 


222 


53 


004 


067 


14 


154 


223 


54 


035 


035 


15 


155 


224 


55 


000 


000 


16 


156 


225 


56 


014 


014 


17 


157 


226 


57 


016 


016 


20 


160 


227 


60 


003 


003 


21 


161 


230 


61 


034 


034 


22 


142 


231 


62 


001 


001 


23 


163 


242 


63 


005 


055 


24 


164 


243 


64 


002 


002 


25 


165 


244 


65 


177 


007 


26 


166 


245 


66 


175 


320 


27 


167 


246 


67 


006 


056 


30 


170 


247 


70 


007 


057 


31 


171 


250 


71 


037 


037 


32 


172 


251 


72 


173 


300 


33 


020 


020 


73 


036 


036 


34 


021 


021 


74 


140 


171 


35 


022 


022 


75 


174 


152 


36 


023 


023 


76 


176 


241 


37 


024 


074 


77 


033 


047 



c 






• l-A-12 
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MESSAGES B 



This appendix contains an alphabetical listing of the messages that may appear in a 
user's dayfile or output file. Lowercase characters identify variable names or fields. 
Messages beginning with variable names or characters follow those beginning with A 
through Z and through 9. These messages are alphabetized according to the first 
nonvariable word or character. Messages beginning with any special characters (such 
as hyphens or asterisks) are alphabetized as if the special character were not present. 
For example, the message 

pfn ALREADY PERMANENT, AT nnn. 

is listed after the messages beginning with A through Z and through 9 and is alpha- 
betized with the messages whose first nonvariable word or character begins with A. 

Dayfile messages usually issued only to COMPASS programs are listed in appendix B in 
volume 2. If a message received during processing of a time-sharing job is not listed 
in this appendix or in appendix B in volume 2, refer to the IAF Reference Manual or 
the Time-Sharing User's Reference Manual. 
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GLOSSARY 



A lphanum eric 
ASCII 



The letters of the alphabet (A-Z) and the numeric digits (0-9). 

American National Standard Code for Information Interchange. 
The standard^ character set code and set used for information 
interchange between systems. ASCII is the default code set 
for 9 -track coded tapes. 



Block 

BOI 

Byte 
Character 

Checkpoint file 

CIO 

Control character 

Control statement 



Control statement 
record 



CYBER Loader 



Data recorded between magnetic tape interrecord gaps; a 
tape PRU. Blocking groups user records for greater trans- 
fer efficiency. 

Beginning-of- information; the point in a file before which no 
file data exists. 

One of the five groups of 12 bits within a 60-bit central 
memory word. 

A symbol whose coded representation may be processed 
within the system. Refer to Alphanumeric, Graphic, and 
Control character. 

File on which the results of a partially completed job are 
dumped when a CKP control statement is processed. 

Combined Input /Output. System routine that performs NOS 
I/O. 

A character whose occurrence within a print file causes an 
action. Examples are the carriage return and line feed 
characters. 

A sequence of words and characters that call a system routine 
to perform a job step. The control statement must conform 
to format specifications and end with either a period or a 
right par entiie sis. 

1. A record containing control statements, such as a proce- 
dure file. 

2. The first record of a job containing the sequence of con- 
trol statements that specifies all steps for job execution 

The NOS product that prepares programs for execution by 
placing program instruction and data blocks in central memory. 
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CYBER Record Manager The NOS product that acts as an I/O interface between CIO 
(CRM) and other NOS products including ALGOL 4, ALGOL 5, 

COBOL 5, DMS-170, FORTRAN Extended 4, FORTRAN 5, 
and PL /I. The CRM functions are split between two file 
processors, Basic Access Methods (BAM) and Advanced 
Access Methods (AAM). Refer to the CRM manuals listed 
in the preface for definitions of CRM file organizations, block 
types, and record types. 



Direct access file 

Display code 
EBCDIC 

Empty PRU /record 
Entry point 

EOF 

EOI 
EOR 

EOT 

FET 
File 



A permanent mass storage file that can be assigned to a 
user's job. All changes to this file are made on the file 
itself rather than a working copy of the file (refer to Indirect 
access file). 

Six-bit code set used to represent characters in central mem- 
ory and in binary files. Appendix A translates the code set. 

Extended Binary Coded Decimal Interchange Code. An 8 -bit 
code set that* if the user requests* NOS uses to read or 
record data on 9-track tapes. 

Refer to Zero-length PRU. 

A location within a program that can be referenced by name 
from other programs. 

End-of-file indicator; the file may be part of a multifile file 
whose end is defined by an EOI indicator. 

End-of-information indicator; marks the end of a named file. 

End-of-record indicator; marks the end of a logical record. 

End-of-tape; metallic strip marking the end of the recordable 
portion of a magnetic tape. 

File Environment Table; a table used by a COMPASS pro- 
grammer to define and interrogate the current status and 
properties of a file assigned to a job. 

1. Data that begins at BOI and ends at an EOI and is ref- 
erenced by a 1- to 7-alphanumeric character name. 

2. A portion of a multifile file ending with an EOF. 

3. Data recorded on a magnetic tape beginning after an 
HDR1 label and ending before an EOF1 label. 

NOS control statements requiring a file name lfn (except tape 
assignment statements) refer to definition 1; NOS control 
statements that have a parameter specifying the number of 
files refer to definition 2. Definition 3 applies only to labeled 
magnetic tapes. 
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File set 



File type 

FIT 

FNT/FST entry 

Frame 

Generation 

Graphic 

Indirect access file 

Input file type 

Interrecord gap 
Job 



One or more .tape files referred to by the lfn on a tape assign- 
ment statement. A file set may consist of: 

• One file recorded on a single volume. 

• More than one file recorded on a single volume. 

• One file recorded on more than one volume. 

• More than one file recorded on more than one volume. 

To conform to the ANSI tape standard, all files within a file 
set must have the same setid in their HDR1 labels. 

A category of files handled similarly by the system. Section 
2 categorizes NOS files according to permanent file types and 
types of files assigned to user jobs. 

File Information Table. The table that defines a file for 
access by CYBER Record Manager. 

File Name Table/File Status Table. Two-word system table 
description of a file currently assigned to a job. 

A tape recording unit made up of one bit from each tape track 
(7 bits for 7 -track tape and 9 bits for 9 -track tape). Each 
frame on a coded tape usually represents 1 character. 

The position of a file within a series of files, each file 
developed from the preceding file. The generation number 
and generation version number of a tape file can be entered 
in its HDR1 label. 

A character that can be printed or displayed. Refer to 
Control character. 

A mass storage permanent file. Indirect access files can 
be accessed only through a working copy of the file. If 
requested, the working copy replaces the permanent file. 

Job file. Its first record is a control statement record which 
may be followed by records containing data, directives, or 
programs used by job steps. 

Space skipped between the writing of data blocks on magnetic 
tape. 

A set of control statements and the data and directives used 
by those statements. A batch job must begin with the job 
and USER statements. A time-sharing job begins at the 
user's login to a terminal. 
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Job step 

Label 

Level number 



Ifn 
Library 



Library file 
Line 

Load point 
Local file 



Logical record 
Mass storage 
Multifile file 

Multifile set 
Noise 



One of the sequence of operations performed within a job. 
Usually, each control statement results in one job step. 
However, a load sequence is a single job step that may 
result from several loader control statements. 

An 80-character block written to identify and /or delimit a 
tape volume or a file. 

Octal number within a PRU terminator indicating the type 
of boundary it represents. A level 17 in an empty PRU is 
a NOS EOF; a level in a short PRU is a NOS EOR; a 
level 1 in a short PRU is an EOR from an interactive ter- 
minal; and a level 16 in a short PRU is an EOF on a check- 
point file. 

Name of a file assigned to the job. 

1. A collection of programs or routines. 

A file containing records that are accessed individually. 



2. 
3. 

4. 



A file searched by CYBER Loader for entry points 
referenced by a program. 

A file containing compressed records in Modify or 
Update format. 



A read-only file that can be accessed by several users 
simultaneously. 

A unit data terminated by a zero-byte terminator. Unit 
used time-sharing I/O, line printer output, and card reader 
inp' 

Metallic strip marking the beginning of the recordable portion 
of a magnetic tape. 

1. A file type that refers to a temporary file other than 
the primary file. It often contains a copy of an indirect 
access file or data from a magnetic tape. 

2. A file currently assigned to a job. 

A unit of data ending with an EOR. 

Magnetic disk or extended memory. 

A file containing more than one logical file. It begins at 
BOI and ends at EOI. On a labeled tape, a multifile file 
is delimited by corresponding HDR1 and EOF1 labels. 

A tape file set having more than one tape file. 

Any tape block less than the minimum acceptable block size 
for its data format. Noise is discarded by the system. 



Nonallocatable devices Magnetic tape unit, card reader, card punch, or line printer. 



l-C-4 



60435400 J 



Parity 

Primary file 
Print file 

PRU 

Punch file 
Random access file 

Record 

Rollout file 
Sequence number 

Sequential access file 
Short PRU 

Tape mark 

Timed /event rollout 
file 

Volume 

VSN 

Working file 
Write ring 



Error detection method for which an extra bit is written per 
byte (or tape' frame) so that each byte always has either an 
odd or an even number of bits set. Parity errors are de- 
tected when the recorded data is read. 

The temporary file designated as the default file by either 
the PRIMARY, NEW, or OLD control statements. 

Output file containing data to be printed. Printing occurs 
at job completion or upon execution of an OUT, ROUTE, or 
DISPOSE statement. 

Physical record unit. Data unit transmitted by a single read 
or write to a device. 

Output file containing data to be punched on cards. 

A file whose records are accessed through a directory con- 
taining the address of each record. 

An individually accessible unit of information. Its further 
definition depends on its context. Physical records, logical 
records, and CRM records can have different delimiters. 

File containing all information concerning a job whose execu- 
tion has been temporarily suspended. 

1. Number at the beginning of each line of a file. 

2. For tape labels, number indicating position of a file 
within a file set. 

File whose records are accessed in the order in which they 
appear. 

A physical record unit containing less than the maximum data 
for a unit. 

Bit sequence written by a tape unit indicating a tape boundary. 

A rollout file whose job is returned to execution when a re- 
quested event has occurred or a specified time period has 
elapsed. 

A reel of magnetic tape. 

Volume serial number. A 1- to 6-character sequence uniquely 
identifying a reel of tape. 

A temporary file currently assigned to a job. 

A circular device inserted into a tape reel indicating to the 
tape unit that it can write on that reel. NOS checks for the 
presence of a write ring if the user requested it. 
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Zero byte terminator Twelve zero- bits in the lowest byte of a central memory word 

that terminate a line. Because the display code for a colon 
is 6 bits of zero, double colons should be avoided. If stored 
in the lowest byte of a central memory word, the colons are 
treated as a zero-byte terminator. Files used with the 
COPYCF, COPYCR, COPYSBF, LIST8G, L072, RESEQ, 
ROUTE, and SUBMIT control statements must contain zero- 
byte terminated lines. Terminal input consists of zero-byte 
terminated lines. 

Zero-length PRU /record A PRU terminator written immediately after another PRU 

terminator; a PRU that contains no user data. 

6/7/8/9 multipunch Signifies a card deck EOI. 

6/7/9 multipunch Signifies a card deck EOF. 

7/8/9 multipunch Signifies a card deck EOR. 
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SAMPLE JOB OUTPUT 



Appendix D Lists the output information printed for the sample job shown below. The notes 
in the right margin identify the various format conventions of NOS output. The job consists 
of the following statements. 

TESTA. 

USER(JEANCOM,PASSrfRD) 

CHARGE(JLC3951,27) 

FTN. 

/EOR 

PROGRAM CONVERC IN PUT, OUTPUT, TAPE5=INPUT, TAPE 6=0UTPUT) 
C 

C INPUT -- 10-DIGIT OCTAL NUMBER, SUCH AS 0000000177 
C OUTPUT -- DECIMAL EQUIVALENT OF OCTAL NUMBER INPUT 
C IF AN 8 OR 9 DIGIT IS ENTERED, THE PROGRAM STOPS. 
C IF A NON-NUMERIC CHARACTER IS ENTERED, THE PROGRAM ABORTS. 
C 

INTEGER NUM, DIGIT, SUM, PLVAL, PLACE 

DIMENSION NUM(10) 

C READS AN OCTAL NUMBER INTO THE NUM ARRAY 
C 

10 READ(5,1000) NUM 
1000 FORMAT(10I1) 

IF (EOF(5>) 50,15 

C CHECKS IF AN 8 OR 9 WAS INPUT 
C 

15 DO 20 1=1,10 

20 IF (NUM(I).EQ.8 .OR. NUM(I).EQ.9) GO TO 50 
C 

C CONVERTS THE OCTAL NUM3ER BY MULTIPLYING EACH DIGIT 
C BY ITS PLACE VALUE AND ADDING IT TO A SUM 
C 

DIGIT=10 
PLACE=0 

SUMrNUM(DIGIT) 
30 DIGIT=DIGIT-1 
PLACE=PLACE+1 

IF (DIGIT. EQ.O) GO TO 40 
PLVAL=NUM(DIGIT) * 3 *« PLACE 
SUM=SUM+PLVAL 
GO TO 30 
C 

C OUTPUTS CONVERTED NUMBER 
C 

40 WRITE(6,4000) SUM 
4000 FORMATOX.IIIO) 
GO TO 13 
50 STOP 
END 
/EOR 
/EOF 



60435400 .J 1-D-l • 



01 U ' 



»«» s ; -Sill 30 !* §o n 5,&i 

:^5 g* =ss,!!s§£!|5ls«; 



5 s >, - m 



*. 3 



•o 



o 



1D-2 



u — _C B^ H o « s SH 3 ai oSE* a .o " u 5 

d 2 *< Sj o u oo 5 -S 

Si» xi" « u So 5 !? 

lO^ » t. oo oo - ^ 

£ 2 a oo oo 

III II 38 So 

. V ^ 09 CH y« #* ,» *« ,« »-» *« *« #-. .* ... J* «« ~« *» .. 



0J- 



'•7? 2 8. OOOOOOOOO OOOOOOO m'O 

» s f 5 a ooouoooooooooo -S 

S%£ *A __ -o g 

3 -8 "8 58 " S^ 

0-33 5 al llMmmmnl 

43 to o> do 



4J ** -J ,fi il 

s 

3 
C 



In 4! « g 2 



= S s 

t* •" <t) 



m I.- 3 Si 

on™ - « 



£ <d h js 43 ^ « « «< 

H ? o fc-t .£,.2, ««««««<««««««««f«« 
«:««*«««* « < « « x « « «•< 



0) 


a 


T? 
















Li 


a 




3 
















£ 


c 
















V 




V 


ti 


a 


u 


^ 


c 




Wl 






c 




a 


DO 




c 


H 


m 


a 



a r o 

L • oe 

£ .*; 7- s* 



>i>-l- « to t«w ww S 

>>W< UIU WW WW E 

> e -^w ww ww z 

v> ww ww 2 

M »■ ■ W W MM 

zz xu 

WW U15C U.U. T3 

ha c< it. -a 

«WZZU.|A. ■**, 

orir 3 U.U. c 

hi is 7 s b. u. u.b. S 

a. ar u. u. u. u. S 

osct«u.u. u. u. ~— 

o uiu u. u. u. u. >, 

-^ trt » u. U. IL. U. 5m 

3 O U. U, b. U. 






60435400 G 



Processing of the FTN. control statement compiles the source program in the second 
record of the job. The following is the program listing and load. map produced by that 
compilation. 



10 



15 



20 



25 



30 



35 



40 



PROGRAM CONVER 73/71 OPTsI FTN 1.8*497 

PROGRAM COITORCINPUT, OUTPUT, TAPE5=INPl^TAPE6=OUTPUT) 



79/05/11. 09.55.13 



PAGE 



INPUT — 10-DIGIT OCTAL NUMBER, SUCH AS 0000000177 

OUTPUT — DECIMAL EQUIVALENT OF OCTAL NUMBER INPUT 

IF AN 8 OR 9 DIGIT IS ENTERED, THE PROGRAM STOPS. 

IF A NON-NUMERIC CHARACTER IS ENTERED, THE PROGRAM ABORTS. 

INTEGER NUM,DIGIT,SUM,PLVAL,PUCE 
DIMENSION NUM(IO) 



C REABS AN OCTAL NUMBER INTO THE NUH ARRAY 
C 

10 READ(5,1000) NUM 
1000 FORMATC10I1) 

IF (EOF(5)) 50,15 

Z CHECKS IF AN 8 OR 9 WAS INPUT 



15 DO 20 Irl, 10 

20 IF CNUM(I).EQ.8 -OR. NUM(I).Eg.9) 



GO TO 50 



CONVERTS THE OCTAL NUMBER BY MULTIPLYING EACH DIGIT 
BY ITS PUCE VALUE AND ADDING IT TO A SUM 

DIGIT* 10 
PUCE=0 

SUM=NUM(DIGTT) 
30 DIGITrDIGIT-1 
PUCE=PUCE+1 

IF (DIGIT.EQ.O) GO TO 10 
PLVAL=HUM(DIGIT) « 8 ** PUCE 
SUH=SUM+PLVAL 
GO TO 30 



C OUTPUTS CONVERTED NUMBER 

C 

10 WRITE(6,4000) SUM 
1000 FORMAT(1X,1I10) 
GO TO 10 
50 STOP 
END 



SYMBOLIC REFERENCE MAP (R=1 ) 



ENTRY POINTS 
4111 CONVER 














VARIABLES SN 
4220 DIGIT 
4225 NUH 
4222 PLVAL 

FILE NAMES 
INPUT 


TYPE 

INTEGER 
INTEGER 
INTEGER 
MODE 


RELOCATION 
ARRAY 

2054 OUTPUT 


4224 

4223 
4221 


I INTEGER 
PUCE INTEGER 
SUM INTEGER 

TAPE5 


FMT 


EXTERNALS 

EOF 


TYPE 
REAL 


ARGS 
1 










STATEMENT LABELS 
4142 10 
1162 30 
4206 1000 FMT 





4173 
4214 


15 INACTIVE 

10 

4000 FMT 


20 
4176 50 


LOOPS LABEL 
1150 20 


INDEX 

I 


FROM-TO 
19 20 


LENGTH 
7B 


PROPERTIES 
INSTACK EXITS 




STATISTICS 

PROGRAM LENGTH 
BUFFER LENGTH 

52000B CM USED 


353B 
3664B 


235 
1972 









2054 TAPE6 



FMT 
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TIME-SHARING INTERFACE 



The time- sharing interface, IAF or the time-sharing executive, processes communica- 
tions between NOS and time-sharing terminals. When in the batch subsystem, the 
time-sharing user can enter any of the control statements described in this manual. 
He can also enter a number of control statements and commands intended for use 
only by time-sharing jobs. The time-sharing control statements and commands are 
described in the IAF Reference Manual and the Time-Sharing User's Reference Manual. 

Tables 1-A-l and l-A-2 list the time-sharing character sets. This appendix describes 
terminal character code conversion and the time-sharing control statements that can 
be included in procedure files. 

TERMINAL CHARACTER CONVERSION 

Normal input mode from an ASCII code terminal uses a 63- or 64-character set where 
all lowercase alphabetics are converted to uppercase characters. Under ASCII mode, 
the characters 74 and 76 represent the beginning of a 74xx or 76xx escape sequence. 
Under normal mode, the characters 74 and 76 are treated as data rather than escape 
codes. ASCII and normal modes apply to both input and output. 

DATA INPUT 

The manner in which the characters entered from a terminal are interpreted by the 
system depends on whether the user requests ASCII or NORMAL mode. For example, 
if the user enters the following characters when in ASCII mode. 

aAbBcCdDeEfF 



The central memory equivalent is:t 



9 




47 




35 




23 




11 




76 


01 


01 


76 


02 


02 


76 


03 


03 


76 


04 


04 


76 


05 


05 


76 


06 


06 


00 


00 



However, if in NORMAL mode when the characters are entered, the characters are 
mapped into the 64-character subset of the ASCII character set that contains only upper- 
case letters; then the central memory equivalent is: 



9 




47 




35 




23 




11 




01 


01 


02 


02 


03 


03 


04 


04 


05 


05 


06 


06 


00 


00 


00 


00 


00 


00 


00 


00 



Refer to appendix A for further description of the time-sharing code sets. 



t Partial words are zero-filled; partial bytes are blank-filled. 
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DATA OUTPUT 

Data output is in either a 64/63- or 128-character set, depending on whether the ter- 
minal is in normal or ASCII mode. When the terminal is in normal mode, the codes 
74 and 76 represent data rather than escape codes. In ASCII mode, 74 and 76 are 
treated as the beginning of an escape sequence. 

For a more detailed description of terminal operation, refer to the IAF Reference 
Manual or the Time-Sharing User's Reference Manual. 

Data can also be transmitted to or from a terminal through a paper tape reader. 

TIME-SHARING CONTROL STATEMENTS 

The user can enter the following control statements in a time-sharing job. For more infor- 
mation on these statements, refer to the IAF Reference Manual or the Time-Sharing User's 
Reference Manual. 



NOTE 



If a time-sharing control statement is included in a 
non-time -sharing job, the system terminates the job. 



ASCII STATEMENT 



The ASCII control statement specifies that further terminal input and output is to be 
interpreted as 6/12 display code. 

The control statement format is: 

ASCII. 

If this control statement is processed while output is still available, the terminal 
switches to ASCII mode for the remainder of the output. 

CSET STATEMENT 

The CSET control statement specifies the current code set of the terminal. 

The control statement format is: 

CSET(m) 

m Current terminal code set; m may be one of the following. 

ASCII Uses 6/12 display code set; escape code process- 

ing. 

NORMAL Uses display code set; escape code processing is 
disabled. 

If this control statement is processed while output is still available, the terminal 
switches to the new character set mode for the remainder of the output. 
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PARITY STATEMENTt 

The PARITY control statement sets the terminal to the indicated parity. 
The control statement format is: 
PARITY(p) 

p Terminal parity; p may be one of the following. 

ODD Set odd parity. 

EVEN Set even parity. 

If p is omitted, odd parity is assumed. 

If this control statement is processed while output is still available, the terminal parity 
switches to the new parity for the remainder of the output. 

TRMDEF STATEMENTtt 

When executed by a time-sharing job, the TRMDEF control statement specifies changes in 
the characteristics of the network terminal that issued the statement. For a detailed 
description of this statement, refer to the IAF Reference Manual. 

The control statement format is: 

TRMDEF(L=lfn,xxj=valuej,xx2=value2, . . ..xXjj^valuejj) 

L=lfn Names optional local file to receive the terminal redefinition 

information. If it names a file other than the output file for the 
terminal, the terminal characteristics do not change until the file 
lfn is copied to the output file for the terminal. 

xxi=valuej A 2 -character parameter mnemonic equated to a legal value for 
that terminal characteristic. The legal value may be entered in 
one of the following formats. 

y Alphanumeric character. 

$y$ Any character, including special characters. 

yyyB Octal value of an ASCII character. 

Xyy Hexadecimal value of an ASCII character. 

The parameter mnemonics and the legal values for terminal char- 
acteristics are listed in the IAF Reference Manual. 



tNot available for IAF. 
TTValid only from IAF. 
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CARD FILE DATA CONVERSION 



Data within the system is stored in binary or coded format. Binary data is variable 
length central memory images. Coded data consists of display-coded characters. Each 
coded line is stored as an even number of characters. If an odd number of characters 
is entered, the system appends a space to make it even. 

This appendix describes the formats for punch cards. It also describes the conversion 
performed by the system on data transferred between the system and card readers and 
punches. 

When using the 64-character set, the user should avoid using consecutive colons (00 
characters). It is possible for these colons to be interpreted as an end-of-line. An 
end-of-line is defined as 12 to 66 zero bits, right-justified in one or two central 
memory words. If consecutive colons appear in the lower 12 bits of a central memory 
word, they are interpreted as an end-of-line rather than as colons. 

Example; 

The following characters are punched on a coded card beginning in column 1. 



::A 



• •*••»*• fk •••«••• 



:AA 



This appears ix. memory as follows: 
59 47 35 



23 



11 



00 00 


00 00 


00 00 


00 00 


00 01 


• • 

• • 


• * 


: : 


: : 


: A 


00 00 


00 00 


00 00 


00 00 


01 01 


• « 

• * 


• • 

• * 


: : 


* • 


A A 


00 00 


00 00 


00 00 


00 00 


00 00 



end-of-line 
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However, if the characters were copied with the COPYSBF utility, the following appears. 



59 



47 



35 



23 



11 



55 00 


00 00 


00 00 


00 00 


00 00 


end -of -line 


01 00 


00 00 


00 00 


00 00 


00 01 


A : 


: 


: : 


: : 


: A 


01 55 


00 00 


00 00 


00 00 


00 00 



Because the COPYSBF utility shifts each line one 6-bit character to the right and adds 
a space, copying nine colons puts 12 zero bits in the last byte of the first word. This 
is interpreted as an end-of-line. 



NOTE 



If a colon is the last character of an input line, 
the system appends a space to perserve the colon 
and then appends an end-of-line. If needed, a 
second space is added to ensure an even number 
of 6-bit characters. Refer to figure 1-F-l. 



INPUT CARD FILE FORMATS 

The system reads cards in coded and binary formats, 
in both formats. 



The following conditions apply 



• A card with a 7/8/9 punched in column 1 is an EOR mark. 

• A card with a 6/7/9 punched in column 1 is an EOFt mark. 

• A card with a 6/7/8/9 punched in column 1 is an EOI mark. 

The remainder of each card is ignored except for columns 79 and 80 of the EOR and 
EOF cards. These columns can contain the keypunch conversion mode for the input 
I records that follow, tt Conversion modes are discussed in Coded Cards. 

CODED CARDS 

Cards are read in Hollerith punch code. The 3447 card reader controller converts the 
Hollerith code to internal BCD code and passes the data to the card reader driver. 

(The driver converts the data from internal BCD code to display code. Up to 80 char- 
acters can be transferred per card. Trailing blank bytes are deleted. If a line has 

tThe 6/7/9 keypunch mark is not supported by either Export/Import or RBF. 
ft HASP terminals can support other forms of separator cards such as /*EOR and 
/*EOI. {Refer to the RBF Reference Manual.) 
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an odd number of characters, one trailing blank is added to make it even. In order 
to preserve the colon (00o) of the 64-character set, a trailing blank byte is either 
retained or appended as the last character in an even line. Examples of coded card 
conversion are shown in figure 1-F-l. 

Conversion Modes 

Two conversion modes, 026 and 029, t exist for the Hollerith punch code. All data 
is converted in the system default keypunch mode unless a conversion mode change is 
specified. This change can be specified on any of the following cards. 

The job card, 7/8/9 card (EOE mark), and 6/7/9 (EOF mark) can contain the keypunch 
conversion mode in columns 79 and 80. A 26 punched in columns 79 and 80 indicates 
that all subsequent coded cards are converted in 026 mode. A 29 indicates that subse- 
quent cards are converted to 029 mode. Each conversion change remains in effect un- 
til another change card is encountered or the job ends. The user can switch between 026 
and 029 mode as often as desired. If 26 or 29 does not appear in columns 79 and 80 
of the job card, the initial keypunch mode of that job is the system default mode. If 
26 or 29 does not appear on a 7/8/9 or 6/7/9 card, no conversion change is made, 
and the most recent keypunch mode remains in effect. 

Keypunch mode can also be changed by a card containing a 5/7/9 punch in column 1. 
A blank (no punch) in column 2 indicates 026 conversion mode; a 9 punch in column 
2 indicates 029 mode. The conversion change remains in effect until another change 
card is encountered or the job ends. 

The 5/7/9 card also allows literal input when 4/5/6/7/8/9 is punched in column 2. 
Literal input allows 80-column binary data to be read while transmitting input in coded 
mode. Cards are read (16 central memory words per card) until a card identical to 
the previous 5/7/9 card (4/5/6/7/8/9 in column 2) is read. The next card can then 
specify the new conversion mode. 

In order to maintain system integrity, an end -of -information card always terminates 
80-column binary input (lieteral input). Either of the following is interpreted as an 
end -of -information card even though it appears in a literal input record. 

• A card with 6/7/8/9 punched in column 1 and with columns 2 through 80 blank. 

e A card with 6/7/8/9 punched in columns 1 and 80 and with columns 2 through 
39 and columns 41 through 79 blank. 



t These codes are ignored by a 200 User Terminal since conversion mode is selected 
by a hardware switch. (Refer to 
Batch Facility Reference Manual.) 



by a hardware switch. (Refer to the Export /Import Reference Manual and the Remote I 
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-SO CHARACTERS - 



FOR 63 AND 64 CHARACTER SETS 

[ « 8 WORDS (80 CHARACTERS! - 



I — l,E 



60 SITS OF 
BINARY ZEROS 

h 



|« 79 CHARACTERS - 



r 




ONE BLANK H RETAINED \ f 
TO MAKE AN EVEN J-l 

NUMBER Of CHARACTERS I 



60L 



-S6 CHARACTERS 



.'* ! NO TRAILING BLANK 

.--' ^i!! 7 *! IS RETAINED SINCE 

f « CHAR. tjS* ! THERE IS AN EVEN 

i I I? j NUMBER OF CHARACTERS 



: MO IN DISPLAY CODE) 

-79 CHARACTERS— — I 



r 



hCj 



13 CHARACTERS WITH 
: AS THE TWELFTH 
CHARACTER 



r 



iXj 



It CHARACTERS WITH 
: AS THE ELEVENTH 
CHARACTER 



r 



FOR 64 CHARACTER SET ONLY 

}» 7 WORDS (70 CHARACTERS)- 



-«| WORD 8 WORD 9 



1 *°" «™„ , 
10 CHAR. WORD 2 



1 CHAHACTER-«fT" 



BLANK (SB ADDED 
TO SEPARATE : FROM 
TRAILING ZEROS 



TTTT 

.11 



38 BITS i 

I OF binary; 

I ZEROS ! 
CD 



EOL 
BLANK ADDED TO 
4 MAKE AN EVEN NUMBER 
I OF CHARACTERS 



1 WORD 

10 CHAR. WORD 2 

I IJ 1 



r-'l 4S BITS OF 
', I BINARY ZEROS ! 
Ill TT1 



EOL 

(BLANK (5SS ADDED 
TO SEPARATE : FROM 
TRAILING ZEROS 
THIS MAKES AN EVEN 
NUMBER OF CHARACTERS 



I 1 



9 CHARACTERS 



±i tr. 



I 48 BITS OF 
I BINARY ZEROS 



•LANK (SSI ADDED 
TO SEPARATE : FROM^ 
TRAILING ZEROS ) 



uJlj 



EJ 



EOL 

•LANK ADOED TO 
MAKE AN EVEN 
NUMBER OF 
CHARACTERS 



Figure 1-F-1. X Examples of Coded Card Conversion 
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BINARY CARDS 

Binary cards are denoted by a 7/9 punch in column 1 and can contain up to 15 central 
memory words. The 3447 card reader controller reads the binary data and passes it 
to the card reader driver in 12 -bit codes. Each card column row corresponds to a bit 
position. The driver checks the checksum figure if this option is specified. The driver 
then passes the data to the central memory buffer. 

The fields within a binary card are: 

Column(s) Description 

1 7/9 punch indicates a binary card. 

4 punch ignores checksum punch in column 2. 

Rows 0, 1, 2, and 3 contain the binary equivalent of the 
word count of the card. 

2 Binary data checksum (modulo 4095). 

3 through 77 15 central memory words of binary data. 

78 Blank. 

79 and 80 24-bit binary card sequence number. 



SUMMARY 

The following punches appearing in column 1 of a card have the corresponding meaning 
to the card reader driver. 

Punch Represents 

End-of-record (optional conversion mode change). 

End-of-file (optional conversion mode change). 

End -of- information. 

Conversion mode change/read 80-column binary. 

Binary card • 

Coded card . 



7/8/9 




6/7/9 




6/7/8/9 




5/7/9 




7/9 




Not 7 and 


9 
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PUNCH FILE FORMATS 

Punched cards can be in three formats. 

• Coded (Hollerith punch) 

• Binary 

• Absolute binary 

The following conditions apply to all three formats. 

• ™ hen r£? EOR J is . encountered, a card is punched with a 7/8/9 in columns 1 and 
80. This card is offset. 

• When an EOF is encountered for a file, a card is punched with a 6/7/9 in 
columns 1 and 80; the remainder of the card is blank. This card is offset. 

m When on TTOT ic AMf-.i*«*+ AMA j ~_ — fci. ^^ . - , . ... - -^ ■ ■ 

.... — — -^ ^ ^^.wu^d «i uii a wc, a cara is puncnea witn a 6/7/8/9 in 
columns 1 and 80; the remainder of the card is blank. This card is offset. 

• If a compare error is encountered, the erroneous card and the following card 
are offset. These two cards are repunched until no error Is detected. An 
EOI card with 6/7/8/9 punches in columns 1 and 80 contains a binary count in 
column 40 of the number of compare errors. 

• During the punching of each file, the system maintains a count of the number 
of cards punched for the file. If the number exceeds the limit for which the 
user is validated, punching of the file is terminated. A special banner card 
with the word LIMIT is punched and offset as the last card of the deck. 

The following methods are used by the system to punch each of the three forms of 
cards. 

CODED CARDS (PUNCH) 

With the exception of decks punched via the DISPOSE request, the keypunch mode 
(026 or 029) of coded cards depends on the job origin type. If the job is of local 
batch origin, decks are punched in the initial keypunch mode (that is, the mode speci- 
fied on the job card or set by system default). For all other job origin types, decks 
are punched in the system default keypunch mode. However, the DISPOSE request 
allows the user to specify that decks be punched in either 026 or 029 mode, regard- 
less of the job's keypunch mode. 
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BINARY CARDS (PUNCHBJ 



The card punch driver retrieves 15 words of binary data from central memory. The 
driver then generates a checksum for the data and issues a card number. The card 
punch controller receives the binary data and punches it on the card unchanged, that is, 
in 12-bit codes. Each row in a card column corresponds to a bit position. The driver 
formats the binary card in the following manner. 



Column(s ) 



3 through 77 

78 

79 and 80 



Contents 

7/9 punch denotes binary card. 

Rows 0, 1, 2, and 3 contain the binary equivalent of the 
word count of the card. 

Binary data checksum (modulo 4095). 

15 central memory words of binary data. 

Blank. 

24-bit binary card sequence number, 



ABSOLUTE BINARY CARDS (P8) 

Absolute binary cards are central memory images in 12-bit codes. Each row in a card 
column corresponds to a bit position. Sixteen central memory words are punched per 
card with no special punches or fields added. 
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ANSI TAPE LABEL FORMATS 



G| 



ANSI labels perform two functions. They provide information that uniquely identifies 

a file and the reel on which it' resides, and they mark the BOI and EOI of a file and I 

the beginning and end of a reel. 

ANSI labels are designed to conform to the American National Standard Magnetic Tape 
Labels for Information Interchange X3. 27-1969. All labels are 80 characters long 
and are recorded at the same density as the data on the tape. The first 3 char- 
acters of an ANSI label identify the label type. The fourth character indicates a number 
within a label type. 

The following is a summary of each label type, name, function, and whether or not it 
is required. 



iype 



No. 



Name 



VOL 


1 


Volume header label 


UVL 


1-9 


User volume label 


HDR 


1 


File header label 


HDR 


2-9 


File header label 


UHL 


t 


User header label 


EOF 


1 


End- of- file label 


EOF 


2-9 


End- of- file label 


UTL 


t 


User trailer label 


EOV 


1 


End- of- volume label 



Used As 



Required /Optional 



EOV 



2-9 



End- of- volume label 



Beginning-of- volume 
Beginning-of -volume 
Beginning-of- information 
Beginning-of- info rmation 
Beginning-of-ihformation 
End-of-ihformation 
End-of-ihformation 
End-of-information 
End-of- volume 

End-of-volume 



Required 

Optional 

Required 

Optional 

Optional 

Required 

Optional 

Optional 

Required when 

appropriate 

Optional 



REQUIRED LABELS 

The VOL1, HDR1, and EOF1 labels are required on all ANSI- labeled tapes. In addition, 
an EOV1 label is required if the physical end-of-tape reflector is encountered before an 
EOF1 label is written or if a multifile set is continued on another volume. In the 
descriptions of the contents of these labels, n is any numeric digit and a is any letter, 
digit, or any of the following special characters. 



|Any member of the CDC 6-bit subset of the ASCII 
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A 


) 


< 


! 


* 


= 


it 


+ 


> 


* 


$ 


? 


$ 


- 


@ 


% 
& 


i 


[ 
\ 


/ 

( 


i 


] 

A 



Some fields are optional. An optional field which does not contain the designated infor- 
mation must contain blanks. Fields which are not described as optional are required 
and written as specified, n-type fields are right-justified and zero-filled, and a-type 
fields are left-justified and blank -filled. 

VOL1 — VOLUME HEADER LABEL 

The volume header label must be the first label on a labeled tape. All reels begin with 
a VOL1 label. If two or more reels belong to a volume set, the file section field in 
the following HDR1 label gives the actual reel number. 



VOL 


1 


volume serial number 


va 


reserved 


reserved 


reserved 


owner 
identification 


owner identification (old) 


oid 


reserved 


reserved 


reserved 


lsl 
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HDR1 - FIRST FILE HEADER LABEL 

The first file header label must appear before each file. When a file is continued on more 
than one volume, the file header label is repeated after the volume header label on each new 
volume for that file. If two or more files are grouped in a multifile set, each HDR1 label 
indicates the relative position of its associated file within the set. 



HDR 


1 


file identifier (fi) 


file identifier (fi) 


fi 


set identification 


file section 
number (secno) 


secno 


file 
sequence number 


generation number 


gvn 


gvn 


creation date 


expiration date 


exp^rajxon j f& 


block count 


system code 


system code 


reserved 

— 
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EOF1 — FIRST END-OF-FILE LABEL 

The end-of-file label is the last block of every file. It is the system end-of-informa- 
tion for the file. A single tape mark precedes EOFl. A double tape mark written 
after the EOFl label marks the end of a multifile set. 



EOF 1 1 


file identifier (fi) 


file identifier (fi) 


fi 


set identification ™S&i£9£*2P.^ 


secno 


file 

sequence number 


generation number 


gvn 


gvn 


creation date | ex 8att tlon 


expiration 
date 


fa 


block count 


system code 


system code 


reserved 
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EOV1 — FIRST END-OF-VOLUME LABEL' 

The end- of- volume label is required only if the physical end-of-tape reflector is en- 
countered before an EOF1 label is written or if a multifile set is continued on another 
volume. EOV1 is preceded by a single tape mark and followed by a double tape mark. 



EOV 



file identifier (fi) 



fi 



file identifier (fi) 



set identification 



file section 
number (secnn) 



secno 



Tile " 

sequence number 



generation number 



gvn_ 



gvn 



creation date 



IK 



expiration 
date 



expiration 
Uate 



block count 



system code 



system coae | 



reserved 
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OPTIONAL LABELS 

Six types of optional labels are allowed. They are additional file header (HDR2-9), 
end-of-file (EOF2-9), end-of-volume (EOV2-9), user volume (UVLa), header (UHLa), 
and trailer (UTLa) labels. 

HDR2-9 — ADDITIONAL FILE HEADER LABELS 

HDR2-9 labels may immediately follow HDR1. Their format is: 



Character 
Position 


Field Name 


Length 
(in characters ) 


Contents 


Default 
Written 


1-3 


Label 
identifier 


3 


HDR 


HDR 


4 


Label number 


1 


2-9 


2-9 


5-80 




76 







Only the label identifier and the label number are checked on read. 

EOF2-9 — ADDITIONAL END-OF-FILE LABELS 

EOF2-9 labels may immediately follow EOF1. Their format is: 



Character 
Position 

1-3 

4 
5-80 



Field Name 

Label 
identifier 

Label number 



Length 
(in characters) 



1 
76 



Contents 
EOF 

2-9 



Default 
Written 

EOF 



2-9 



Only the label identifier and the label number are checked on read. 
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Refer to section 3 in volume 2 for a description of the use of EOV2 labels in conjunction 
with CLOSER, REWIND, and UNLOAD macros. 

USER LABELS 

User labels may immediately follow their associated system labels. Thus, user volume 
labels (UVLa) may follow VOL1, user header labels (UHLa) may follow the last HDRn 
'label, and user trailer labels (UTLa) may follow the last EOVn or EOFn label. Their' 
format is: 



Character 
Position 

1-3 



Field Name 

Label 
identifier 



Length 
(in characters) 



Contents 



UVL, UHL, or UTL. 



Default 
Written 

UVL, UHL, 
or UTL. 



Label number 



Must be 1, 2, 3, 4, 
and so on, consec- 
utively for UVL labels. 
For other labels, any 
a character. 



5-80 



User option 



76 



Any a characters. 



Only the label identifier and the label number are checked on read. The system checks 
the number ef user labels of a label type; a maximum of 64 is allowed. 
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CONTROL LANGUAGE (KCL) H 



The control language (KCL) described in this appendix is the system control language 
available under NOS prior to the introduction of the CYBER Control Language (section 
4). Support of KCL will be dropped in a future NOS release, and users are encouraged 
to convert their KCL procedures to CYBER Control Language. 

The following paragraphs describe the various components and commands of KCL. If 
a KCL component is identical to its CCL counterpart, the user is referred to its de- 
scription in section 4. 

EXPRESSIONS 

The expressions allowed are similar to FORTRAN expressions and may contain con- 
stants, operators, functions, and symbolic names. 

OPERATORS 

The arithmetic, relational, and logical operators are the same in the control language 
outlined in this appendix as they' are in the CYBER Control language described in 
section 4. The only exception is the exclusive OR logical operator, .EOR. 

FUNCTIONS 

Two functions are provided for use in expressions specified with control language state- 
ments. The FILE function determines the status of any file assigned to the job. The 
NUM function determines if a specified parameter name has a numeric value. For 
complete information concerning format and use, refer to Control Language Functions 
in this section. 

SYMBOLIC NAMES 

Symbolic names are used to reference values pertaining to the job process. There are 
three categories of symbolic names, as follows: 

• Symbolic names with fixed arithmetic values: 

ARE Arithmetic error. 

BCO Local batch origin. 

CMM Maximum CM field length (MFL setting). 

CMN Nominal CM field length (RFL setting). 

CPE CPU abort. 

ECM Maximum ECS field length. 

ECN Nominal ECS field length. 
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EIO Remote batch origin. 

FLE File limit error. 

| FSE Forced error. 

MNE Monitor call error. 

ODE Operator drop. 

IOKE Operator kill drop. 

ORE Override error. 

PEE CPU parity error exit. 

PPE PPU abort. 

PSE Program stop error. 

I RRE Rerun error. 

SRE SRU limit error. 

SSE Subsystem aborted. 

| SYE System abort. 

SYO System origin. 

TKE Track limit error. 

TLE Time limit error. 

TXO Time-sharing origin. 

• Symbolic names with variable arithmetic values which depend upon job state: 

EF Previous error flag. 

EM Current exit mode. 

FL Job field length. 

OT Job origin type. 

Rl Contents of control register 1. 

R2 Contents of control register 2. 

R3 Contents of control register 3. 

SS Job subsystem. This particular symbolic name requires an 

equal sign. SS may be equivalenced to one of the following: 

I ACCESS 

BASIC 

BATCH 
EXECUTE 
| FORTRAN 

FTNTS 
NULL 
TRANACT(for TAF/TS only)t 



tS P e fi a JjfL i ^ atio " I s nece ssary to use the library update and batch transaction functions 
of TRANACT. Refer to the LIMITS statement in section 6. 
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• Symbolic names with Boolean values: 

F False value. 

FALSE False value. 

SWn Setting (1 is on, is off) of sense switch (l<n<6). 

T True value. 

TRUE True value. 

EVALUATION OF EXPRESSIONS 

The order of evaluation of expressions is: 

1 . Exponentiation 

2. Miltiplication, division 

3. Addition, subtraction, negation 

4. Relations 

5. Complement 

6. AND 

7. Inclusive OR 

8. Exclusive OR, equivalence 

Nesting of expressions to any depth is allowed within a statement. 
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CONTROL LANGUAGE STATEMENTS 

Control language statements are described in the following paragraphs. Separators 
and terminators must be used as shown in the statement formats. For descriptions 
of the SET and DISPLAY statements, refer to section 4. 

GOTO STATEMENT 

The GOTO statement transfers control to another location within the control statement 
file. 

The statement format is: 



GOTO, stmt, 
stmt 



Name of any control statement or a digit (0 through 9) followed 
by a maximum of 6 alphanumeric characters, terminated by a 
period. 



Example 1 



Example 2 



GOTO 



1WX2 



1WX2. 



REQUEST (TAPED 



GOTO 



REQUEST (TAPED 



REQUEST. 



REQUEST (TAPE 2) 
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When stmt appears more than once in the control statement file, the stmt to be executed 
is the first occurrence of stmt from the beginning of the control statement file. Hence, 
in both of the previous examples, the REQUEST (TAPE!) statement is processed after 
the GOTO statement. 



CALL STATEMENT 

The CALL statement allows the user to insert a file consisting of a group of control state- 
ments (procedure file) at the specified position in the control statement stream. This 
file is merged, as specified on the CALL statement, with the current control statement 
record into a third record. This third record becomes the current control statement rec- 
ord. The remainder of the input file is then copied to the new control statement record. 
If the C option is exercised, the current control statement record is not used. Only the 
source file is used to generate a new control statement record. The C and S options are 
order-independent; the RENAME option, if present, must be last. 

Lines within a procedure file may contain line numbers to make maintenance easier. 
Usually, the CALL statement strips off these line numbers before copying the procedure 
statements to the new control statement record. However, if a comma immediately 
follows the line number, the line number remains on the statement. 

The statement format is: 

CALL(lfn,C,S=ccc,RENAME(oldnami=newnam 1 ,oldnam2=newnam2, .... 
oldnam n =newnam n ) 

or 

CALL(lfn, C, S=ccc(oldnam 1 =newnam 1 , oldnajx^newnamg, .... oldnam n =newnam n ) 

Ifn Procedure file name (refer to the description of procedure files 

in this section for further information). The system obtains Ifn 
by: 

Searching for a local file, Ifn 

» Searching the system library for Ifn 

• Attempting to retrieve a working copy of an indirect 
access file 



S=ccc 



RENAME 



oldnam; 



new nam.- 



Replaces all of the control statement record after the CALL 
statement with Ifn. 

Sets next control statement to be processed to statement ccc. 
If S is not specified, the first statement in Lfn is processed. 

Each occurrence of oldnanij; is replaced with newnam^ before 
the statement is entered into the statement file. As shown by 
the optional format, the word RENAME does not have to appear. 

Old name; name of a file or statement label used in the speci- 
fied procedure file. 

New name; name to replace oldnam^. 
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If lfn is not properly formatted for a procedure file, the following message is issued. 
Ifn NOT A PROCEDURE FILE. 

IF STATEMENT 

The IF statement is used to evaluate an expression. If the conditions given in the expression 
are true, the dependent statement is processed. The expression is considered true if it is 
evaluated to a nonzero numeric value. 

The statement format is: 
IF(expression)stmt. 

or 
IF(SS=ssname)stmt. 

expression Any legal expression? 

stmt Any legal control statement, 

ssname Any legal SS subsystem name. 



NOTE 



A statement of the form IF(expression)CALL 
(lfn) is not recommended. Each time the IF 
statement is processed and the expression is 
true, the CALL statement is processed. This 
merges the called lfn with the current control 
statement stream and creates a copy of this 
procedure file each time. 



Example 1: 



IF(R2=R 1. AND. R3)GOTO, R EQUEST. 
SET(EF=1) 



REQUEST (TAPE) 



If the expression is true, the REQUEST control statement is executed; otherwise, the SET 
statement is executed. 



f If a permanent file controL statement is included in an IF statement, a password 
(if present ) is not deleted in the dayfile. 
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Example 2 : 



IF(SS=BASIC)GOTO, 100. 
SET(SS=BASIC) 



100, OLD, BAS. 



If the statement is true, the OLD control statement is processed; otherwise, the SET state- 
ment is processed. 

CONTROL LANGUAGE FUNCTIONS 

Control language functions are described in the following paragraphs. Separators and 
terminators must be used as shown in the function formats. 



FILE FUNCTION 

The FILE function is used to determine the status of any file assigned to the job and 
is used in conjunction with the SET, IF, and DISPLAY control language statements. 

The format of the function is: 

FILE(lfn, expression) 

lfn File name, 

expression Any legal expression; however, FILE expressions cannot 

include functions. In addition, FILE expressions use 
different symbolic names, as follows: 

Symbolic names: 

Names with values: 

EQ- Equipment status table (EST) ordinal! 

(0 through 77g). 
ID File ID (0 through 67 g ). 

File characteristics: 

MS File is on mass storage. 

LK File is locked. 

OP File is opened. 

EX Execute -only file. 

AS File is assigned to user's control point. 

File types: 

LO Local. 

PR Print. 

IN Input. 

PH Punch. 

LI Library. 

PM Direct access permanent file. 

PT Primary. 



tContact installation personnel for a list of EST ordinals. " 
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Device types: 



CP 
CR 
DE 

DI 

DJ 

DK 

DL 

DM 

DP 
DQ 

LP 
LR 
LS 

LT 
MS 
MT 
NE 
NT 
TT 
NP 



415 Card Punch. 

405 Card Reader. 

Extended core storage. 

844-21 Disk Storage Subsystem (half 

track). 

844-4x Disk Storage Subsystem (half 

track). 

844-21 Disk Storage Subsystem (full 

track). 

844-4x Disk Storage Subsystem (full 

track). 

885 Disk Storage Subsystem (half 

track). 

Distributive data path to ECS. 

885 Disk Storage Subsystem (full 

track). 

Any line printer. 

580-12 Line Printer. 

580-16 Line Printer. 

580-20 Line Printer. 

Mass storage. 

Magnetic tape drive (7-track). 

Null equipment. 

Magnetic tape drive (9-track). 

Time-sharing terminals. 

Host communications processor. 



Examples : 

SET(R1=FILE(TAPE,MT)) 

If TAPE is a file on a 7-track magnetic tape drive, Rl is set to 1; otherwise, it is 
set to zero. 

IF(FILE(BETA,DI.AND.PM))GOTO,200. 

If BETA is a file on an 844-21 Disk Storage Subsystem and it is a direct access per- 
manent file, control skips to the statement at 200. 
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NUM FUNCTION 

The NUM function is used to determine if the specified parameter name has a numeric 
value. It is used in conjunction with the SET, IF, and DISPLAY control language state- 
ments. 

The format of the function is: 

NUM(name) 

name Parameter name. If the name is numeric, the statement is 

true; otherwise, it is false. 

Example: 



If the following CALL statement is used to call procedure file A 

CALL(A,RENAME(2XY=2, T=TAPE)) 
the IF statement in A 

IF(NUM(2XY))GOTO, IS. 
is evaluated as true, and control transfers to IS. 
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However, the statement 

IF(NUMfT) )GOTO, IS. 
is evaluated as false, and control passes to the next statement in A, 

PROCEDURE FILES 

Procedure files are source files consisting of control statements, control language state- 
ments, or both. The first statement of a procedure file may be the file name. If the 
first statement is the same as the file name used in the CALL statement, the first 
statement is ignored. Procedure files are activated by the CALL statement or by using 
the name of the procedure file, if the file is in the system. 

Example 1: 



rnl . 



1UC t«-weuure lue m mis example is an indirect access file called COMPARE This 
routine copies an input file and compares it with an existing direct access file! In the 
procedure file, these two files are called DUPL and MASTER. When the procedure 
file is inserted into the control statement record during job processing, the name of 
DUPL is changed to NEWFILE. 

Original Input File 

JOBAAA. 

USER(EFD2501, PASS) 
CHARGE(59, 69N1) 

CALL(COMPARE(DUPL=NEWFILE) 
-EOR- 

input file 
that is to 
be compared 

-EOI- 

Procedure File COMPARE 

COMPARE 
COPYBR(, DUPL) 
ATTACH (MASTER) 
VFYLIB(MASTER, DUPL) 
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After the CALL control statement is processed, the control statement record is as 
follows: 

JOBAAA. 

USER(EFD2501, PASS) 

CHARGE(59,69N1) 

CALL(COMPAR E(DUPL=NEWFILE )) 

COPYBR(, NEWFILE) 

ATTACH (MASTER) 

VFYLIB(MASTER, NEWFILE) 

-EOR- 

Example 2: 

This is an example of nested calls. It illustrates the use of one procedure file to 
skip a specified number of files on a tape (contents of Rl) and to copy source data to 
the tape. The other procedure file retrieves source data from the OPL (old program 
library) and calls the first procedure file to place that source data on the tape. 

Input Deck 

JOBAAA. 

USERfUSERNUM, PASSWRD, FAM1) 

CHARGE(59, 69N1) 

A TTA CH(OPL / UN =LIBRAR Y ) 

REQUEST(TAPE) 

MODIFY(S, Z) /*EDIT, CPM 

SET(R1=0) o nA 

CALL(PROC,RENAME(A=TAPE,B=SOURCE,2=2A,3=3A) 

SET(R1=R1+D 

CALL(PROB) 

-EOR- 

Procedure File PROB 



PROB 

MODIFY(S=NEW, Z)/ *EDIT, MTR 

C ALL(PROC, RENAME ( A =T APE, B=NEW) 

RETURN, NEW. 

Procedure File PROC 

PROC 

REWIND(A, B) 

SET(R2=0) 

2,IF(Rl=R2)GOTO,3. 

SKIPF(A) 

SET(R2=R2+1) 

GOTO, 2. 

3,COPYBF,B,A. 



NOTE 



On job initiation, the user's input file is a locked file. 
If the user wishes to call procedure files that write 
data on the input file, he should enter the RETURN 
(INPUT) control statement before attempting to write 
on INPUT. For further information, refer to Input 
File Control in section 3. 
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LINE PRINTER CARRIAGE CONTROL 



This appendix briefly describes the format and processing of print files. T It lists the 
carriage control for the programmable format control (PFC) and non-PFC 580 line 
printers. 

PRINTED DATA 

All data to be printed is in coded format in a print file within the print queue. The 
data consists of either 6 -bit or 12 -bit codes. Data recorded using the 6/12 display 
code set (refer to appendix A) should be converted to the 12 -bit ASCII code set (refer 
to the FCOPY statement in section 7) before being routed to a line printer. 

The system extracts data until an end-of-line occurs or until 137 characters are 
retrieved. End-of-line is 12 or more zero bits in the rightmost byte of a central 
memory word. 

CARRIAGE CONTROL 

The system interprets the first character in a line as the carriage control character "ft 
and that character is not printed (table 1-1-1). The remainder of the line is then 
printed, except when the Q, R, S, or T carriage control characters are specified. 
The Q, R, S, T, and V format controls remain in effect until changed; all other 
carriage control characters must be supplied for each line they control. Line spac- 
ing is normally done in auto eject mode; that is, creases in the paper are skipped 
by the line printer's automatic line spacing mechanism if the paper is loaded properly. 
Auto eject mode must be turned off if the user wants to select format channels to 
advance printing from a position above the bottom of form to a position beyond the 
next top of form. 

During the printing of each file, the system maintains a count of the number of lines 
printed or skipped for the file. If the number exceeds the limit for which the user 
is validated, printing of the file is terminated. The informative diagnostic LINE 
LIMIT EXCEEDED is printed. If a job's dayfile is part of the terminated print file, 
the dayfile is subsequently printed. . 

The installation can impose an implied page control by setting a certain number of 
default lines for each page. If less than the default number of lines is printed or 
skipped on a page, the line limit is still decremented by the default number of lines. 



t To print a file in which the first character of each line is not a carriage control 
character, refer to the COPYSBF control statement in section 7. 
ft The information in this appendix does not apply to remote batch line printers. 
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TABLE 1-1-1. CARRIAGE CONTROL CHARACTERS 



Character 


Action 


SPACE 


Single space. 




1 


Eject page before print. 







Skip one line before print (double space). 




- 


Skip two lines before print (triple space). 




+ 


Suppress space before print. 




/ 


Suppress space after print. 




2 


Skip to last line of form before print. 




Q 


Clear auto eject; TT remainder of line is not printed. 




R 


Set auto eject; remainder of line is not printed. 




S 


Select 6 lines /inch; remainder of line is not printed. 




T 


Select 8 lines /inch; remainder of line is not printed. 




V 


Eject page before print on a 580 PFC printer, V loads a user- 
supplied PFC array (validated users only). 




8 


Skip to next punch in format channel 1 before print, t 




7 


Skip to next punch in format channel 2 before print, f 




6 


Skip to next punch in format channel 3 before print, f 




5 


Skip to next punch in format channel 4 before print, f 




4 


Skip to next punch in format channel 5 before print, f 




3 


Skip to next punch in format channel 6 before print. T 




H 


Skip to next punch in format channel 1 after print. 




G 


Skip to next punch in format channel 2 after print. 




F 


Skip to next punch in format channel 3 after print. 




E 


Skip to next punch in format channel 4 after print. 




D 


Skip to next punch in format channel 5 after print. 




C 


Skip to next punch in format channel 6 after print. 




TNo space after 
after print, 
t tThe deselectio 
tion of 8 lines 


print. For all other control characters, a line feed is issued 

n of auto eject mode on a 580 line printer results in the deselec- 
per inch, if previously selected. 
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CARRIAGE CONTROL USING FORMAT CHANNEL SELECTION 

A programmer can use carriage control characters (table 1-1-1) that refer to channels 
(tracks) on a punched carriage control tape or in a programmable format control (PFC) 
array. The carriage control character beginning a print file line determines where on 
the printer form the line is printed. 

After reading the carriage control character for a print line, the printer checks the 
format channel the character references. If a punch exists at that frame in that 
channel of the carriage tape or if a bit is set in that frame and channel of the PFC 
array, the printer prints the line. If not, the printer advances the carriage tape or 
PFC array and advances the printer paper until a punch or set bit is found in that 
channel. It then prints the line. 

As listed in table 1-1-1, some carriage control characters name an action to be taken while 
others directly name a format channel. When specifying characters feat name an action, 
the user indirectly names the format channel that performs the named action. To use the 
characters that directly name a format channel, the user needs to know the contents of the 
channel. 

The format of the carriage control tape recommended for use on a 580 non-PFC line 
printer is listed in table 1-1-2. Lines 132 through 134 are identical to lines through 
2 because they overlap when the punched tape is glued together to form a continuous 
loop. Therefore, the user can disregard lines 132 through 134. 

Selecting format channels on the carriage tape illustrated in figure 1-1-1 produces the 
following actions. 



Carriage 

Control 

Character 


Format 
Channel 
Selected 


8 or H 


1 


7 or G 


2 


6 or F 


3 


5 or E 


4 


4 or D 


5 


3 or C 


6 



The line printer advances to: 

Line or 66. 

First line of the next two-line group. 
First line of the next three-line group. 
First line of the next four-line group. 
First line of the next five-line group. 
Line 0. 

If the numeric carriage control character is specified, the printer advances before 
printing. If the alphabetic character is specified, the printer advances after printing. 
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Frame 


Channels 




1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


II 


12 





X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 




1 






















X 




2 




X 


















X 




3 






X 












X 




X 




4 




X 




X 














X 




5 










X 












X 




6 




X 


X 












X 




X 




7 














X 








X 




8 




X 




X 








X 






X 




9 






X 












X 




X 




10 




X 






X 










X 


X 




11 






















X 




12 




X 


X 


X 










X 




X 




13 






















X 




14 




X 










X 








X 




15 






X 




X 








X 




X 




16 




X 




X 








X 






X 




17 






















X 




18 




X 


X 












X 




X 




19 






















X 




20 




X 




X 


X 










X 


X 




21 






X 








X 




X 




X 




22 




X 


















X 




23 






















X 




24 




X 


X 


X 








X 


X 




X 




25 










X 












X 




2G 




X 


















X 




27 






X 












X 




X 




28 




X 




X 






X 








X 




29 






















X 




30 




X 


X 




X 








X 


X 


X 




31 






















X 




32 




X 




X 








X 






X 




33 






X 












X 




X 




34 




X 


















X 




35 










X 




X 








X 




36 




X 


X 


X 










X 




X 




37 






















X 




38 




X 


















X 




39 






X 












X 




X 




40 




X 




X 


X 






X 




X 


«J 




41 






















X 




42 




X 


X 








X 




X 




X 




43 






















X 




44 




X 




X 














X 




45 






X 




X 








X 




X 




46 




X 


















X 




47 






















X 




48 




X 


X 


X 








X 


X 




X 




49 














X 








X 




50 




X 






X 










X 


X 




51 






X 












X 




X 




52 




X 




X 














X 




53 






















X 




54 




X 


X 












X 




X 




55 










X 












X 




56 




X 




X 






X 


X 






X 




57 






X 












X 




X 




58 




X 


















X 




59 






















X 




60 




X 


X 


X 


X 








X 


X 


X 




61 






















X 




62 




X 


















X 




63 






X 








X 




X 




X 


X 


64 














. 










65 


i 























Frame 



66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

no 

111 

112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 



Channels 



Figure 1-1-1. Carriage Control Tape Format 
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CARRIAGE CONTROL ARRAYS FOR 580 PFC PRINTERS 

Line spacing on a 580 programmable format control (PFC) line printer is controlled 
by a PFC array that acts as a software version of the carriage control tape in non- 
PFC printers. The printer has two default PFC arrays, one for 6 lines-per-inch 
print density and the other for 8 lines-per-inch print density. The default arrays 
are listed in the System Maintenance Reference Manual. If validated (refer to the 
LIMITS statement, section 6), the user can include a PFC array in the print file to 
control its spacing until another PFC array or the end of the print file is reached. 
This user-supplied PFC array begins with the carriage control character V. 



NOTE 



The PFC array does not change the print density. 
Print density is selected by an S or T carriage 
control character. 

Upon reading a V carriage control character, the line printer page ejects. If the 
printer is not a PFC printer, the rest of the line is ignored. If the user is not 
validated to use the V carriage control character, the print file terminates, and the 
user is informed by a message in his output file. 



NOTE! 



The V carriage control character is ineffective 
when a print file is routed from a time- sharing 
job. 

PFC ARRAY SYNTAX 

The carriage control character V is in column 1 of the line. The character in column 
2 determines which PFC array is changed. Its legal values are the following. 

6 Six-line-per inch spacing. The entire array specification is on this line. 

8 Eight-line-per-inch spacing. The entire array specification is on this line. 

C Eight-line-per-inch spacing. The array specification is continued on a second 
line. The second line begins in column 3. Columns 1 and 2 are ignored. 

The PFC array specifications start in column 3. They are the alphabetic characters 
A through L, O, and blank and have the following significance. 

A Specifies top of forms code. This must be the first character in 

.the array. 

B through K Specifies format channels 2 through 11, t respectively. 

L Specifies bottom of forms code. 

O Signals the end of the array specification. This must be the last 

character in the array. It has no effect on printing. 

Blank No channel specified. 



tThe A character refers to channel 1, and L refers to channel 12. In the maximum 
length array specification (132 for six lines-per-inch and 176 for eight lines-per-inch), 
the J character can be specified only in the last position (immediately before the O). 
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NOTE 



The user must specify each channel referenced in 
the print file in the PFC array. A channel speci- 
fication can be repeated. 

A six-line-per-inch array specification may be a maximum of 132 characters plus the 
array terminator. An eight-line-per-inch array specification may be 176 characters 
plus the array terminator. 

If the array contains an illegal character, the array line is printed and the print file 
is terminated. Other invalid arrays are ignored and the file is printed using the 
carriage control array previously loaded into the printer. 

Examples: 

The following arrays are invalid. 

V6BCD O Array does not be«in with an A. 

VBA C DEO Second character is not 6. 8, or C. 
V8ABWCO Contains an illegal character (W). 

The following example uses a PFC array to print a short special form. 

A programmer wants to print on the top, fifth, and bottom lines of an eight-line form 
(eight lines-per-inch print density). He selects the print density with the T carriage 
control character and then loads the following PFC array. 

Columns: 123456789 10 11 
V 8 A B L O 

The eight lines-per-inch carriage control array is changed as follows (x denotes a 
bit set): 



Channels 
2 3 4 5 6 7 8 9 10 11 12 



1 
2 
3 

4 
5 
6 
7 
8 



Because only 3 of the 12 format channels are specified in the array, the other 9 
channels (in the eight lines-per-inch array) remain unchanged from their last setting. 

After loading the array, output lines beginning with an 8 (format channel 1) are printed 
at the top of form, lines beginning with a 7 (format channel 2) are printed at the fifth 
line, and lines beginning with a 2 (format channel 12) are printed at the bottom of the 
form. 
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INDEX 



A directive 1-14-15 

A mode (refer to APPEND mode) 

AAM 1-1-6 ' 

Conflict with READ and READAP file 
access modes 1-8-4 
AB 1-6-10 
Abort job 1-5-6 
ABS record type 1-14-2 
Absolute binary punch output 1-2-9; l-F-7 
Access 

Date 1-8-12,16 

Limits 1-6-11 

Mode 1-8-2,3,7,8,13 

Word 1-6-11 
Accessibility, tape 1-10-7; l-G-3, 7 
Accessing 

Direct access files 1-8-7 

Indirect access files 1-8-14 

Labeled tapes 1-10-9 

Library type files 1-7-4 

Multiple files 1-8-6 

Permanent files on an auxiliary device 
1-8-15 

Unlabeled tapes 1-10-5, 9, 16 
Account block 1-3-7; 1-6-24 
Account dayfile information 1-3-10 
ACCOUNT statement 1-6-2 
Accounting 1-3-4 

Information 1-3-10 
ADD directive 1-14-11 
Address out of range 1-6-13; 1-12-3 
Address registers 1-12-4 
AFTER directive 1-14-15 
Aging jobs 1-3-5 
Alphanumeric 1-C-l 
Altering an indirect access file 1-8-18 
Alternate checkpoint files 1-11-3 
Alternate access validation 1-8-2 
Alternate user 

Access information 1-8-9 

Number 1-2-11; 1-8-2 
American National Standard Magnetic Tape 
Labels for Information Interchange 
X3.27 - 1969 (refer to ANSI tape standard) 
ANSI labels 1-2-6,7; 1-10-12; 1-G-l 
ANSI tape standard 1-2-6; 1-10-2. 9, 12; 

1-G-l 
ANSI standard labeled tapes 1-2-6 
ANSI tape label formats 1-G-l 
Answerback identifier 1-6-10 
APPEND mode 1-8-3 
APPEND statement 1-8-7 



Appending information 

To a direct access file 1-8-3 

To an indirect access file 1-8-7 
Appending selected records to a file 1-14-5 
ARG= entry point 1-5-3 
Arithmetic operators 1-4-3 
ASCII 1-A-l; 1-C-l 

Character set 1-A-l, 4 

Code set 1-A-l 

Coded magnetic tapes 1-2-5; l-A-10 

Graphic character set l-A-4, 6 

Statement l-E-2 

Terminals 1-7-5; 1-E-l 

Time-sharing mode l-A-2; 1-E-l 
Editing 1-13-1,13 
Assembler languages 1-1-5 
ASSIGN statement 1-7-2; 1-10-5 
Assigning 

Device residence 1-2-12 

Disk packs 1-6-22 

Field length 1-3-5, 6 

Files 1-7-1,2 

To tape units 1-10-5 
To tape device 1-10-9 

Nonallocatable devices 1-6-11 

Resources 1-6-18 to 1-6-23 

Tape units 1-6-20:1-10-1,5 
Associating file name with tape volume 

1-10-18 
ATTACH statement 1-8-7 
Auto eject mode 1-1-1 
Automatic file permission 1-8-2, 10 
Auxiliary device 1-2-13; 1-8-5 

Access 1-8-5 

Maximum 1-6-10 

Requests 1-8-5,8,15 



B directive 1-14-13 

B format tape file 1-7-40 

Bad tape blocks 1-10-4 

Backspace before copy 1-7-17 

Backspacing 

Files 1-7-38 

Records 1-7-3 
Backup system 1-2-13; 1-6-35 
BAM 1-1-6 
Banner page l-D-2 
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Basic Access Methods (refer to BAM) 
BASIC source program line number 

referencing 1-7-31 
Batch character and code sets l-A-3,6 
Batch origin 1-3-2 

BATCHIO subsystem privileges 1-6-12 
BCD 

Code 1-A-ll 

Coded magnetic tapes 1-2-5; l-A-10 
Conversion to display code l-A-10 
BCOT (refer to Batch origin) 
BEFORE directive 1-14-13 
BEGIN statement 1-4-28 
Beginning-of-information (refer to BOI) 
Binary 

Cards l-F-4, 6 

Comparison of files 1-7-47 

Copy 

Files 1-7-11 
Records 1-7-12 

Data 1-F-l 

File 1-6-31; 1-7-11 

Magnetic tape files 1-2-5 

Punch output 1-2-9; l-F-7 

Record 1-9-4; 1-F-l 

Record management 1-14-1 
BKSP statement 1-7-3 
Blank labeling a tape 1-10-7 
BLANK statement 1-10-7 
Block 1-2-3; 1-C-l 

Count l-G-7, 9, 11 

Terminator 1-2-3, 7 
Block transmission terminal 1-7-5 
BOI 1-2-2; 1-C-l 
BUILD directive 1-14-13 

Building a random access directory 1-14-13 
Byte 1-C-l 



CALL statement l-H-4 
Calling a procedure 

CCL 1-4-28 

KCL l-H-4 
CAP record type 1-14-2 
Card 

Deck structure 1-2-3 

File 1-2-4 

Data conversion 1-F- 

Formats l-F-2 



Punch 


1-1-4 


Reader 


1-1-4 


Cards 




Binary 


l-F-5,7 


Coded 


l-F-2 


Input 1 


-F-2 


Punched 


l-F-6 



Carriage control 1-1-1 

Characters 1-2-9; 1-1-2 

Tape 1-1-3 
Carriage return delay 1-6-10 
CATALOG statement 1-14-3 

Examples 1-14-22 
Catalog track 1-2-5 
Catalog, user 1-2-11; 1-8-2,9 
Cataloging file records 1-14-3 
Category, file 1-8-2 
CATLIST statement 1-8-9 
CCCCCCC 1-7-30 
CCCCCCO 1-11-1 
CCL 1-4-1 

Conditional statements 1-4- 

Expressions 1-4-3 

Functions 1-4-18 

Iteration statements 1-4-11 

Label strings 1-4-7 

Literals 1-4-5 

Operands 1-4-5 

Operators 1-4-3 

Statement syntax 

Symbolic names 



1-4-2 
1-4-5,6, 13, 19 



CDC graphic character set l-A-1,6 
CEJ/MEJ (refer to Central exchange jump/ 

monitor exchange jump) 
Central exchange jump/monitor exchange 

jump 1-1-2 
Central library directory 1-5-6 
Central memory (refer to CM) 
Central memory control input error (refer 

to CMC input error) 
Central memory resident (refer to CMR) 
Central processor time 1-5-5; 1-6-27; 

(also refer to CPU execution time) 
Maximum 1-6-10,27 
Central processor unit (refer to CPU) 
CHANGE statement 1-8-11 
Changes in residence 1-14-20 
Changing 

File characteristics 1-8-11 
File names 1-7-28 
User password 1-6-16 
Character 1-C-l 
Character code conversion 1-A-l; 1-E-l; 

1-F-l 
Character set conversion 1-7-5 
Character sets 1-A-l 
Charge number 1-6-2,11 
CHARGE statement 1-3-7; 1-6-2 
Checkpoint 1-11-1 

Dumps 1-7-29; 1-11-1 
File 1-7-29; 1-11-1; 1-C-l 
Checksum 1-14-4 
CIO 1-C-l 
CKP statement 1-11-1 
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CLEAR statement 1-7-6 
Clearing central memory 1-9-5 
Clearing file error status 1-8-12 
CM 

Block range error 1-12-4 

Checkpoint dump 1-11-1 

Data error 1-12-3 

Direct range error 1-12-4 

Dumps 1-9-1,2; 1-12-1 

Error 1-12-4 

Field length 1-5-5; 1-6-22 

Maximum 1-6-10 

Time slice 1-3-8 
CMC input error 1-12-3 
CMR 1-1-3 
Code set 1-A-l 

ASCII l-A-4,6, 11 

BCD 1-A-ll 

Display 1-A-l, 4,6 

EBCDIC 1-A-ll 

Hollerith punch l-A-6 

026 punch code l-A-6 
029 punch code l-A-6 
12-bit ASCII 1-A-l, 2, 4, 6 
6/12 display 1-A-l, 4, 6 
Coded 

Cards l-F-2, 6 

Copy 

Files 1-7-12,13 
Records 1-7-14 

Data 1-F-l 

Lines 1-F-l 

Magnetic tape files 1-2-5 
Colon code interpretation l-A-2; 1-F-l 
Comment 

Following control statement 1-5-3 

Within CCL procedure 1-4-28 

Within record prefix table 1-14-4,13 
COMMENT directive 1-14-13 
COMMENT statement 1-6-3,34 
*comment statement 1-6-3 
COMMON statement 1-7-4 

Comparing 

File record sequence 1-14-20 

Files 1-7-47 
Compiler languages 1-1-5 
Completion of a job 1-3-10,11 
Compressing COMPASS listings 1-7-22 
Concurrent file access 1-8-3,8 
Conditional statements 1-4-7 
Configurations, PP 1-1-4 
Configurations, tape file 1-2-6 
Continuation lines 1-4-35; 1-5-2 

Tape statements 1-10-2 
Control character 1-2-9; 1-A-l; 1-C-l 
Control language (refer to CCL or KCL) 



Control point 1-1-2 

Control statement buffer 1-5-6 

Dayfile 1-3-11 
Control statement 1-5-1; 1-C-l 

Format 1-5-1,2 

Limit 1-3-8 

Loop 1-4-11 

Parameters 1-5-4 

Processing 1-5-1 

Processing flow 1-5-6, 7 

Record 1-3-1; 1-C-l 
Control statements 1-5-1 

Checkpoint/ restart 1-11-1 

File management 1-7-1 

Job control 1-6-1 

Library 1-14-1 

Load/dump central memory utility 1-9-1 

Loader control 1-5-1 

Permanent file 1-8-1 

System utility 1-13-1 

Tape management 1-10-1 

Time-sharing l-E-2 
Conversion, 63-character set 1-7-5 
Conversion mode 1-5-5; 1-10-3; l-F-3 
CONVERT statement 1-7-5 
Converting 

Code sets 1-7-21 

Obsolete tape formats 1-7-40 

Update format to Modify format 1-13-12 

63-character set files 1-7-5 
COPY directive 1-14-14 
COPY statement 1-7-6 
Copy 

Block size 1-7-8,10 

Count 1-7-8 

Error limit 1-7-8 
Termination 1-7-7. 8, 10 
COPYBF statement 1-7-11 
COPYBR statement 1-7-12 
COPYCF statement 1-7-12 
COPYCR statement 1-7-14 
COPYEI statement 1-7-15 
Copying 

Binary files 1-7-11 
Binary records 1-7-12 
Coded files 1-7-12,13 
Coded records 1-7-14 
Files 1-7-6 

To be printed 1-7-16 
ToEOI 1-7-15 

To specified record type 1-7-17 
Multifile files 1-7-15 
New file records over old file 1-14-14 
COPYSBF statement 1-7-16; l-F-2 
COPYX statement 1-7-17 
Correction statement images 1-9-5 
Correspondence code terminal 1-7-5 
COS record type 1-14-2 
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CPE flag 1-4-33 
CPU 1-1-2 

Abort (refer to CPE flag) 

Assignment to control points 1-1-2 

Dayfile output 1-3-11 

Error exit 1-3-9 

Mode 1-3-9; 1-6-13 

Execution time 1-1-2; 1-6-6 

Hardware error exit mode 1-6-13 

Multiplier 1-3-11 

Priority 1-6-26 

Program 1-1-5 

Error exit mode 1-3-9; 1-6-13 

Registers 1-12-1,4 

Time limit 1-3-7; 1-6-10 
CPUMTR 1-1-3 
Creating 

Direct access file 1-8-12 

Indirect access file 1-8-18 

Labeled tape 1-10-9 

Library file 1-2-10; 1-7-4 

Local files 1-2-10 

Multifile set 1-10-9,10 

Primary files 1-2-10:1-7-26; 
1-8-6,14 

Tape files 1-10-5,9, 16 

Tape labels 1-10-7, 9 

Unlabeled tape 1-10-5, 9, 16 
Creation date 

File record 1-14-4 

Mass storage files 1-8-16 

Tape file 1-10-12; l-G-6 
CRM 1-1-6; l-C-2 

Blocking type 1-2-2 

Conflict with READ and READAP file 
access modes 1-8-4 

File organization 1-2-2 

File structure 1-2-2 

Record type 1-2-2 
Cross reference, system symbols 1.-13-2 
CSET statement l-E-2 
CT option 1-8-2 
CTIME statement 1-5-6; 1-6-3 
Current time 1-4-6 

CYBER control language (refer to CCL) 
CYBER Interactive Debug utility 1-12-1 
CYBER Loader 1-1-6; 1-C-l 

Adjusting field length 1-3-6 

Loading from libraries 1-2-14 

Record types 1-14-2 

User library generation 1-14-19 
CYBER Record Manager (refer to CRM) 



D directive 1-14-14 

Data formats, magnetic tape 1-2-7 

. DATA command 1-4-26 

DATE directive 1-14-14 

Dayfile 

Example l-D-4 

Messages 1-B-l 

Printing 1-3-11; 1-6-3 
Dayfile skipped control statement flag 

(refer to DSC flag) 
DAYFILE statement 1-6-3 
DDP 1-1-4 

Deadlock prevention 1-6-19 
DEBUG mode 1-6-11; 1-10-5 
Debugging aids 1-12-1 
Deck structure 1-13-1,2 
Decreasing job priority 1-6-26 
Decrementing resource demand count 

1-6-22; 1-7-32 
Default LIBEDIT record type 1-14-11, 17 
Deferred batch jobs 1-6-10,27; 1-7-33,34 
Deferred routed queue files 1-7-20, 33, 34, 35 
DEFINE statement 1-8-12 
DELETE directive 1-14-14 
Density resource identifier 1-6-20 
Density, tape 1-2-5 

For 9-track labeled tape 1-10-2 
Device 

Auxiliary 1-2-13 

Number 1-8-11, 14 

Permanent file 1-2-12 

Residence 1-2-12,13 

Statistics 1-2-5 

Type 1-4-20; 1-7-2; 1-8-5 
Mnemonics 1-4-20,21 
Diagnostic messages 1-B-l 
Direct access file type 1-2-10; l-C-2 

Accessing 1-8-7 

Block sizes 1-2-5, 12 

Changing characteristics 1-8-11 

Defining 1-8-12 

Interlock 1-2-12; 1-8-7 

Maximum size in PRUs 1-2-5; 1-6-11 

Purging 1-8-16,17 

Space 1-2-5; 1-8-5 
Direct access permanent file 1-2-12 

(also refer to Direct access file type) 
Directives 

Escape character 1-6-28 

GTR 1-14-6 

LIBEDIT 1-14-9 

PROFILE 1-13-8 
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Disable program exit mode 1-6-13 
Disk packs (refer to Packs) 
Disk storage units 1-1-4; (also refer to 
Mass storage) 

Logical structure 1-2-5 
Dismounting packs 1-6-23 
Dismounting tapes 1-6-23 
Displaycode 1-A-l, 4,6, 11; l-C-2 

Dumps 1-9-2,4 
DISPLAY statement 1-4-17 
Displaying expression evaluation 1-4-17 
DISPOSE statement 1-7-18 
Disposition code 1-7-34 
Disposition of job output 1-7-18; 1-7-26; 

1-7-33,34 
Distributive data path (refer to DDP) 
DMD statement 1-9-2 
DMDECS statement 1-9-4 
DMP statement 1-9-1 
DMP subroutine 1-12-2 
DMPECS statement 1-9-3 
DOCMENT statement 1-7-19 
DSC flag 1-4-16 
DT function 1-4-20 
Dump 1-3-9; 1-7-44; 1-12-1 

Restrictions 1-3-9 
DUMP FORTRAN subroutine 1-12-5 
Dumping 

Central memory 1-9-1,2; 1-12-1 

Duplicate lines 1-7-45; 1-9-2,3,4 

ECS 1-9-3,4 

Files 1-7-44 

From time-sharing terminal 1-3-9; 
1-9-2,3,4 
Duplicate 

Dump lines 1-7-45; 1-9-2,3, 4 

Tape volumes 1-10-10, 19 



E format tape file 1-7-40 
E mode (refer to EXECUTE mode) 
EACP loader table 1-3-5 
EBCDIC l-C-2 

Coded magnetic tape 1-2-5; l-A-10 
EBCDIC /display code conversion 1-A-ll 
EC directive 1-6-31 
ECS 1-1-3 

Dumps 1-9-3,4 

Field length 1-5-5; 1-6-11, 12, 23; 
1-9-3,4; 1-12-4 

Files 1-2-3,4; (also refer to Mass 
storage) 

Flag register operation parity error 
1-12-3 

Reference address 1-12-4 
EDIT statement 1-13-1 



Editing 

Modify-formatted files 1-13-3 
Text files 1-13-1,13 
Update-formatted files 1-13-9 
EF error flag 1-4-12, 13 
EFG error flag 1-4-12, 13 
EIOT (refer to Remote batch origin) 
ELSE statement 1-4-9 
EM 1-1-3 

Empty PRU/record l-C-2 
Empty records, writing 1-7-50 
EM-M 1-12-2 
EM-N 1-12-2 
End of file (refer to EOF) 
End of file CCL command 1-4-28 
End of file label (refer to EOF1 label) 
End of information (refer to EOI) 
End of line byte l-F-2; 1-1-1 
End of record (refer to EOR) 
End of record CCL command 1-4-28 
End of reel (refer to End of tape) 
End of tape l-C-2 

Conditions 1-10-3 
Processing 1-2-5; 1-10-3,4 
Reflector 1-G-l 
End of volume label 1-G-l, 10, 18 
ENDIF statement 1-4-8 
ENDW statement 1-4-11 
Enforce ring 1-10-4 
ENGINEERING mode 1-6-11 
ENQUIRE statement 1-6-4 
ENTER statement 1-6-7 
Entering comment in record prefix table 

1-14-13 
Entering data lines 1-6-15 
Entering date and comment in record prefix 

table 1-14-14 
Entry point l-C-2 
EOF 1-2-2,3; l-C-2 

Card 1-2-3,4; l-F-2 
Command 1-4-28 
Directive 1-6-29 
EOF1 label 1-2-7; 1-G-l, 18 
EOF2 -9 labels 1-G-l, 12 
EOI 1-2-2,3 

Card 1-2-3,4; l-F-2 
EOR 1-2-2,3; l-C-2 

Card 1-2-4; 1-3-1; l-F-2 
Command 1-4-28 
Directive 1-6-29 
EOT (refer to End-of-tape) 
EOV1 label 1-2-7; 1-G-l, 10 
EOV2- 9 labels 1-G-l, 19 
Equipment /file assignment 1-7-2; 1-10-5 
Equivalence mode 1-4-36 
EREXIT macro 1-12-4 
Error 

Conditions 1-6-13; 1-8-19 
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Control 1-3-9; 1-12-2 
Exit 1-3-9 

Address 1-3-9; 1-12-4 
Conditions 1-6-13 
Control 1-12-4 
Mode 1-3-9; 1-6-13 
Flag 1-4-12; 1-5-8; 1-6-13 

Values 1-4-13 
Inhibit 1-10-3 
Messages 1-10-4; 1-B-l 
Processing 1-3-9; 1-5-8; 1-6-13 
Mass storage files 1-8-19 
Tape files 1-10-3 
Status, permanent file 1-8-9 
Escape character 1-6-31 
EST ordinal 1-7-2; 1-10-5 
Evaluation of control language expressions 

1-4-4; l-H-3 
EVICT statement 1-7-20 
Exchange jump 1-1-2 
Exchange package 1-1-2 

Dumps 1-9-2; 1-12-1 
EXECUTE mode 1-8-3 
Execute-only direct access file 1-8-3 

Checkpointing 1-11-1 
Exit mode 1-3-9; 1-12-3 
Exit processing 1-5-8; 1-6-8, 14, 16 
EXIT statement 1-3-9; 1-5-8; 1-6-8; 

1-12-5 
Expiration date 1-10-7,9,12; l-G-6 
Explicit file permission 1-8-2,4, 16 
Export/Import 1-1-1; 1-5-5; l-F-2,3 
Expressions 

CCL 1-4-3 
KCL 1-H-l 
Extended core storage (refer to ECS) 
Extended memory (refer to EM) 
External BCD (refer to BCD) 
External reference /entry point linkage 

1-14-19 
Extracting COMPASS documentation 1-7-19 



F tape format 1-2-7 
Family 1-2-13 

Device 1-8-5 

Name 1-2-13; 1-6-34; 1-7-36 
F COPY statement 1-7-21 
FET l-C-2 
Field length 1-1-2 

Assignment 1-3-5; 1-5-5; 1-6-12,23 

Control 1-3-5 

Dumps 1-12-1 

In exchange package 1-12-3 

User defined 1-3-6; 1-6-23 
File 1-2-1; l-C-2 

Access methods 1-14-1 



Accessibility, tapes 1-10-7 

Block sizes 1-2-5 

Category 1-8-2 

Dump 1-7-44 

Header label 1 - G- 1 , 4 

ID code 1-7-37 

Identifier 1-10-4; l-G-5 

Management control statements 1-7-1 

Manipulation control statements 1-7-1 

Mark indicators 1-2-3 

Name 1-2-1; l-C-4 

Call statement 1-5-2 
Change 1-7-28; 1-8-10 
Reserved 1-2-1 
Table (refer to FNT/FST) 

Password 1-8-2 

Permission 

Categories 1-8-2 
Mode 1-8-14 

Positioning 1-7-3,4,33,38,39 

Purging 1-8-16,17 

Reservation block 1-2-5 

Residency 1-2-12; 1-8-13 

Saving 1-8-16 

Section number 1-10-10; l-G-2,5 

Sequence number 1-10-10; l-G-5 

Set l-C-3 

Set label configurations 1-2-6 

Space 1-8-14 

Status table (refer to FNT/FST) 

Structure 1-2-1 

Type 1-2-8; l-C-3 
FILE directive 1-14-15 
FILE function 

CCL 1-4-18 

KCL l-H-6 
Files, maximum number assigned 1-6-10 
First word address (refer to fwa) 
FIT l-C-3 

FL (refer to Field length) 
FLE 1-9-3,4 

Floating point arithmetic unit 1-6-13 
FNT/FST 1-2-8; l-C-3 
Force unload 1-10-3 

Foreign data format (refer to F tape format) 
Format channel selection 1-1-3 
Forms code 1-7-35 

FORTRAN compile and execute deck 1-3-2 
Frame l-C-3 
Frame count 1-10-4 
FST entry (refer to FNT/FST) 
FULL duplex transmission mode 1-6-10 
Full-track recording mode 1-2-5 
Functions 

CCL 1-4-18 

KCL l-H-6 
fwa 1-9-1,2 
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GE write mode 1-10-3 
Generating 

CM dumps 1-12-4 

Modify OPL cross-reference listing 
1-13-2 

Random access directory 1-14-5, 7, 13 
For user library 1-14-19 
Generation l-C-3 

Number 1-10-12; l-G-6 

Version number 1-10-12; l-G-6 
GET statement 1-8-14 
gid entry 1-14-11 
Global control register 1-4-12 
Global error flag 1-4-12 
GOTO statement l-H-3 
Graphic character 1-A-l; l-C-3 
Group record identifier 1-14-11 
GTR statement 1-14-4 

Examples 1-14-22 



HALF duplex transmission mode 1-6-10 
Half-track recording mode 1-2-5 
Hardware components 1-1-1 
Hardware error conditions 1-3-9; 1-12-3 
Hardware error correction, tape units 

1-10-3 
Hardware error exit status bits 1-12-3 
HDR1 label 1-2-7; l-G-1,4 
HDR2-9 labels l-G-18 
Header label (refer to HDR 1 label) 
Header, procedure 1-4-22 
Hexadecimal ASCII codes l-A-10 
HHA 1-3-5 

Hollerith punch code l-F-2 
Hollerith punch output 1-2-9; l-F-6 
HTIME statement 1-5-6; 1-6-8 



Accessing 1-8-14 

Appending information 1-8-7 

Block size 1-2-5,12 

Changing characteristics 1-8-11 

Creating 1-8-18 

Maximum size in PRUs 1-6-10 

Purging 1-8-16,17 

Replacing 1-8-18 

Saving 1-8-18 

Space available 1-6-10 
Infinite operand 1-6-13 
INFT 1-2-8 
Inhibit unload 1 - " C - 5 
Initial 

Control statement limit 1-3-8 

Field length 1-3-6; 1-6-23 

Time-sharing subsystem 1-6-10 
Initiating a job 1-3-1 
Input 

File control 1-3-7 

File type 1-2-8; l-C-3 

Queue 1-2-8; 1-3-5, 13 
INPUT file 1-3-7 

Checkpointing 1-11-1 
INPUT* file 1-3-7 
INSERT directive 1-14-15 
Inserting records 

After a reference record 1-14-15 

Before a reference record 1-14-13 

Before a zero- length record 1-14-11 
Integer constants 1-4-5 
Interactive Facility (refer to IAF) 
Iterative statements 1-4-11 
Interchangeable families 1-2-13 
Interlock 1-8-7 

Internal data format (refer to I tape format) 
Interrecord gap l-C-3 



I tape format 1-2-7 

I directive 1-14-15 

IAF 1-1-1; 1-3-2 

ID 1-2-9 

IF statement l-H-5 

IFE statement 1-4-8 

IGNORE directive 1-14-15 

Ignoring LIBEDIT replacement records 

1-14-15 
Increasing the number of scheduled units 

1-6-22 
Increment registers 1-12-4 
Indefinite condition 1-12-4 
Indefinite mode 1-12-3 
Indefinite operand 1-6-13; 1-12-3 
Indirect access permanent files 1-2-12; 

l-C-3 



Job 1-3-1; l-C-3 
v Abort 1-10-6 

Accounting 1-3-4 

Card 1-5-4 

Communication area 1-5-4 

Completion 1-3-10 

Control 1-3-5; 1-6-1 

Deck 1-3-1 

Example 1-D-l 

Field length 1-3-5; 1-5-5; 1-8-23 

Dump 1-12-1 
File 1-2-8 

Structure 1-3-1 
Flow 1-3-1 
Initiation 1-3-1 
Name 

In system 1-3-3; 1-6-7 
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On job statement 1-5-5 
Origin type 1-3-2 
Output information 1-D-l 
Priority 1-3-5; 1-6-26 
Processing 1-5-1 
Restart 1-11-1 
Scheduling 1-3-5 
Statement 1-5-4 
Structure 1-3-1,7 
Suspension 1-8-6; (also refer to 

Rollout) 
Termination 1-3-10 
Validation 1-3-4 
Job step 1-3-1,7,9; 1-5-5; 1-6-23; 
l-C-4 

Field length 1-6-12,23 
Time limit 1-5-5; 1-6-27 



KCL 1-H-l 

Keypunch modes 1-2-4; l-F-2,3 

Keyword substitution 1-4-25,31,35 

Keywords 1-5-4 

KRONREF statement 1-13-2 



L tape format 1-2-7 

ANSI standard 1-10-2 
Label 1-2-6; l-C-4; 1-G-l 

Identifier l-G-3, 5, 9, 11, 20 

Number l-G-3, 5, 9, 11, 20 

Standard level 1-10-9 

Types 1-2-7; 1-G-l 
LABEL statement 1-10-9 
Label string 1-4-7 
Labeling a tape 1-10-7 
Large central memory (refer to LCM) 
Large central memory extended (refer to 

LCME) 
Last word address (refer to lwa) 
LBC statement 1-9-4 
LCM 1-1-3 
LCME 1-1-3 

Block range error 1-12-4 

Direct range error 1-12-4 

Error 1-12-4 
LDI statement 1-3-3; 1-6-9 
Legal user 1-6-2 
LENGTH statement 1-6-9 
Level number l-C-4 
lfn l-C-4 (also refer to File name) 
lfn/VSN association 1-10-1,18 
LGO 1-8-3 

Checkpointing 1-11-1 



LIBEDIT '1-14-7 

Directive syntax 1-14-10 

Directives 1-14-9 

Errors 1-14-18 

Examples 1-14-22 

Output 1-14-18 

Statement format 1-14-8 
LIBGEN statement 1-14-19 

Examples 1-14-22 
Libraries 1-2-13 
Library 1-2-13; 1-14-1; l-C-4 

File type 1-2-10; l-C-4 

Maintenance 1-14-1 

Record 1-14-1 

Types 1-14-2 
LIBRARY user number 1-2-13 
LIFT 1-2-8 
LIMITS statement 1-3-4; 1-6-10 

Line length 1-4-35 

CCL statements 1-4-22 

SUBMIT files 1-6-31 
Line numbers 1-6-28,29 

On KCL procedures l-H-4 

Resequencing 1-7-30 

Sorting 1-7-39 
Line printers (refer to Printer) 
Line spacing l-F-7; 1-1-1 
Listing 

File record information 1-14-3 

Permanent file information 1-8-9 

Tape labels 1-10-15 
LISTLB statement 1-10-15 
LIST80 statement 1-7-22 
Literal card input l-F-3 
Literals 1-5-2 

In tape statement parameters 1-10-2 
Load map 1-12-1, 5, 10 
Load point l-C-4 
Load/dump central memory utility control 

statements 1-9-1 
Loader libraries 1-2-14 
Loading (also refer to CYBER Loader) 

Binary data 1-9-4 

Binary record 1-9-6 

Octal line images 1-9-5 

User library routines 1-14-19 
LOC statement 1-9-5 

Local batch origin (refer to Batch origin) 
Local file control statements 1-5-1 
Local file 

Saving 1-8-18 

Type 1-2-10 
Locating data on a memory dump 1-12-6 
LOCK statement 1-7-22 
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Locked file 1-3-7 
LOFT 1-2-8 
Logical 

Device, mass storage 1-2-4 

File structure 1-2-1 

On mass storage 1-2-4 

Operators 1-4-4 

Record 1-2-2; l-C-4 

Track on mass storage 1-2-4 
Long Block Stranger data format (refer to 

L tape format) 
Looping 1-4-11 
L072 statement 1-7-23 
lwa 1-9-1 



M mode (refer to MODIFY mode) 
Magnetic disk (refer to Disk storage units) 
Magnetic tape (refer to Tape) 
Main overlay 1-12-5, 7 
Memorex 1240 terminal 1-7-5 
Managing tapes and packs 1-6-18 
Manipulating files 1-7-1 
Mass storage l-C-4 
Mass storage checkpoint file 1-11-2 
Mass storage device statistics 1-2-5 
Mass storage file (also refer to Permanent 
files) 

Errors 1-8-19 

Residence 1-2-12; 1-8-5. 13 

Size 1-2-5; 1-8-5.13,14 
Maximum 1-6-11 

Structure 

Logical 1-2-4 
Physical 1-2-3 
Master user 1-13-7 
MAXFL 1-3-5 
Maximum 

Field length 1-3-5; 1-5-5 

Cards punched 1-6-11 

CM field length 1-3-5; 1-5-5 

Control points 1-1-2 

Control statements in batch job 1-6-11 

Dayfile messages 1-6-11 

Deferred batch jobs 1-6-10 

ECS field length 1-6-11 

Files assigned to job 1-6-10 

Lines printed 1-6-11 

Output files i-6-11 

Permanent files 1-6-10 

Removable pack devices 1-6-23 

Size of direct access file 1-6-11 

Time 1-3-7 
Memory 

Allocation 1-3-5,6 

Dumps 1-9-1" 

Dump restrictions 1-3-9 



Releasing 1-3-6; 1-6-24 
Memory boundaries 1-12-1 
MERGE file 1-13-10 
Messages 1-B-l 
MFL 

Setting 1-3-6 

Statement 1-6-12 
MFL= entry point 1-3-5 
MODE statement 1-3-9; 1-6-13 
Modification date 1-8-12.16 
Modification decks 1-13-4 
Modification identifiers 1-13-4,5 
MODIFY statement 1-13-3 
MODIFY mode 1-8-3 
Modify- formatted program library file 

1-2-14; 1-13-3 
Monitor address 1-12-4 
Monitor mode 1-12-3 
Multifile file 1-2-2; l-C-4 

Catalog listing 1-14-21 

Copying 1-7-15 

Tape 1-10-1 
Multifile set 1-10-9; l-C-4 
Multimainframe configuration 1-1-3; 1-6-21 
Multiple access 1-8-7,8 
Multiple VSNs 1-10-10 
Multiplexers 1-1-4 
Multiprogram processing 1-1-2 
Multivolume file set 1-10-10,19,20 



N mode (refer to NULL mode) 

NA option (refer to No abort option) 

NAM 1-1-1 

NAME directive 1-14-17 

ND option (refer to No drop option) 

Nested calls to procedure files 1-4-29, 30 

Network Access Methods (refer to NAM) 

Network processing modes 1-1-1 

Network processing units 1-1-4 

New password 1-6-16 

NEW statement 1-7-26 

NEWPL file 1-13-10 

NF 1-6-10 

No abort option 1-8-6 

No drop option 1-8-6 

No-replace file 1-14-16 

NOEXIT statement 1-3-9; 1-5-8; 1-6-14; 

l-i.4-4 

Noise l-C-4 
Noise size 1-2-7 

Nonallocatable device 1-6-11; l-C-4 
Nonstandard labeled tapes 1-2-6 
Nonstandard labels 1-2-6 
NOPACK directive 1-6-29 
NOREP directive 1-14-16 
NORERUN statement 1-6-14 
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NORMAL time-sharing mode l-A-2; 1-E-l 
NOS 1-1-1 

File structure 1-2-2 
NOSEQ directive 1-6-29 
NOS/BE default tape format 1-10-6 
NOTE statement 1-6-15 
NOTRANS directive 1-6-30 
NPLfile 1-13-3 
NULL mode 1-8-4 
NUM function 

CCL 1-4-21 

KCL l-H-8 



Overcommitment of resources 1-6-21 

Overflow condition 1-12-4 

Overflow mode 1-12-3 

OVL record type 1-14-2 

Owner 

Auxiliary pack 1-2-13 
Identification 1-10-6; l-G-3 
Labeled tape 1-10-9 

026 punch code 1-5-5; l-A-6; l-F-3 

029 punch code 1-5-5; l-A-6; l-F-3 



Obtaining 

Accounting information 



1-3-4.10 



Accumulated SRU usage 1-6-27 

TtjT^r4**l 1 7g r*lr\r*\r ntm[g />i-»«ri+ 1 -fi-g 

System information 1-6-32 

Time since last deadstart 1-6-24 
Octal 

Dump 1-9-1,3 

Line image loading 1-9-5 
OFFSW statement 1-6-15 
Old password 1-6-16 
OLD statement 1-8-6, 14 
OLDPL file 1-13-10 

ONEXIT statement 1-5-8; 1-6-16; 1-12-4 
ONSW statement 1-6-16 
On-the- fly error correction 1-10-3 
Operand out of range 1-6-13; 1-12-3 
Operand registers 1-12-4 
Operands, control language 1-4-5 
Operating system 1-1-5 

Control statement format 1-5-1,2 

Version 1-4-5 
Operator tape assignment 1-10-2, 10, 16 
Operators 

CCL 1-4-3 

KCL 1-H-l 
OPLfile 1-13-3 
OPL record type 1-14-2 
OPLC record type 1-14-2 
OPLD record type 1-14-2 
OPLEDIT statement 1-13-5 
Optional tape labels 1-G-l, 18 
Order-dependent format 1-5-3 
Order- independent format 1-5-4 
Origin type 1-3-2 
OUT statement 1-7-26,27 
Output file 1-2-9 
OUTPUT file l-2r9 

Checkpointing 1-11-1 
Output information 1-D-l 



PACK directive 1-6-29 

Pack name 1-2-8; 1-8-5, 15 

PACK statement 1-7-27 

Packing file as one record 1-7-27 

PACKNAM statement 1-8-15 

Pack management 1-6-18 

Paging control 1-1-1 

Paper tape l-E-2 

Parallel processor 1-6-33 

Parameter field 1-5-2 

Parameters, control statement 1-5-4 

Parameters, number of characters 1-5-3 

Parity l-C-5 

Parity errors on F format, 7-track tape 

1-2-8 
Parity on magnetic tape 1-2-8 

Error processing 1-10-3 
PARITY statement l-E-3 
PASSWOR statement 1-6-16 
Password 

Changing 

File 1-8-11 
User 1-6-11,16 

File 1-8-2 

User 1-6-34 
PBC statement 1-9-5 
Peripheral hardware 1-1-4 
Peripheral processor (refer to PP) 
Peripheral processor library directory 

1-5-6 
Permanent file 1-2-11 

Auxiliary device request 1-8-15 

Catalog 1-8-2 

Control statements 1-8-1 
Parameters 1-8-2 

Devices 1-2-13; 1-8-5. (also refer to 
Mass storage devices) 

Device family 1-2-13 

Error status 1-8-9 

Information 1-8-9 

Name change 1-8-11 
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Permissions 1-8-2,3 
Purging 1-8-16,17 
Size 1-2-5 

Maximum 1-6-10 
System 1-8-1 
Permission 

Information 1-8-9 

Mode 1-8-2,3 
PERMIT statement 1-8-16 
Permitting an alternate user to access a file 

1-8-16 
PFC printer 1-1-1 

Array 1-1-5 
PHFT 1-2-8 

Physical file structure 1-2-2,3 
Physical record unit (refer to PRU) 
Plotter 1-7-34 
PMFT 1-2-8 
Positional mode 1-4-35 
Post error cleanup 1-5-8 
PP 1-1-4 

PP record type 1-14-2 
PPU 1-1-4 

PPU record type 1-14-2 
Prefix character 1-5-2 
Prefix table 1-9-6 

Preserving the ECS field length 1-6-17 
Presetting memory 1-6-25 
Preventing 

File release 1-8-6 

Writing on a file 1-7-22 
PRFT 1-2-8 
Primary file type 1-2-10; 1-7-28; 1-8-14; 

l-C-5 
Primary overlay 1-12-5, 9 
PRIMARY statement 1-7-27 
Primary terminal files 1-2-10 
Print density 1-1-1 
Print file 1-2-9; l-C-5 

Priority 1-2-9 
Print queue 1-2-9; 1-1-1 
Print trains l-A-3 

Transmission errors l-A-3 
Printed data 1-1-1 
Printer 1-1-4 

Carriage control 1-1-1 

Control characters 1-2-9 

Usage l-A-3 
Priority 

Job 1-3-5 

Print file 1-2-9 

Queued file 1-2-8 
Priority level 1-5-5 
Private file 1-8-2 

Granting access to 1-8-16 
Private pack 1-2-13; 1-6-22 
.PROC command 1-4-22 
PROC record type 1-14-2 



Procedure 1-4-22 
Body 1-4-22,2 5 
Call 1-4-28 
Commands 1-4-26 
Exit 1-4-33 . 
Files 1-4-22 
Header 1-4-22 
KCL l-H-9 
Keywords 1-4-23 
Line length 1-4-22 
Structure 1-4-22 
Processing modes 1-1-1 
Processing options for tapes 1-10-3 
Product set 

Control statement format 1-5-2 
Control statements 1-5-1,2 
Library 1-2-14 
PROFILE statement 1-13-7 
Program 1-1-5 

Address 1-12-3 

Address register 1-9-2 

Error exit mode 1-6-13; 1-12-2 

Errors 1-12-1 

Library 1-2-14 

Library utility control statements 

1-13-1 
Name field 1-5-2 
Range error 1-12-4 
Status designator register (refer to 
PSD register) 
Programmable format control (refer to PFC) 
Project number 1-6-2, 11 
PROTECT statement 1-6-12, 17 
PRU 1-2-2; l-C-5 

Magnetic tape 1-2-3 
Mass storage 1-2-3 
Punched cards 1-2-3 
PRU size 1-2-1 

Pseudo- sense switches 1-6-15,16,33 
PSD register 1-12-3 
PTFT 1-2-8 
Public file 1-8-2, 9 
Public packs 1-2-13; 1-6-22 
*PULLMOD directives 1-13-6 
Punch code l-A-6; l-F-6, 7 
Punch file 1-2-9; l-C-5 
Formats l-F-6 
Names 1-2-9 
Routing 1-2-9; 1-7-34 
Structure i-2-3 
PUNCH file 1-2-9; l-F-6 
Checkpointing 1-11-1 
Punch queue 1-2-9 
PUNCHB file 1-2-9; 1-9-5; l-F-7 

Checkpointing 1-11-1 
Punched card format 1-F-l 
Punching binary records 1-9-5 
PURGALL statement 1-8-16 
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PURGE statement 1-8-17 
Purging files 1-8-16,17 

In use 1-8-17 
P8 1-2-9; l-F-7 

Checkpointing 1-11-1 



Queue priority 1-3-5,8 
Queued files 1-2-8 



R mode (refer to READ mode) 

RA 1-1-2; 1-12-3 

RA access mode (refer to READAP mode) 
Random access 1-14-1 

Directory 1-14-1 

File l-C-5 

File structure 1-14-2 
RBF 1-1-1; 1-3-2; 1-5-5; l-F-2,3 
RBR statement 1-9-6 
READ directive 1-6-30 
READ mode 1-8-3 
READAP mode 1-8-3 
Reading 

Binary data 1-9-4 

Binary records 1-9-6 

CM dumps 1-12-5 

I format tapes 1-2-7 

Statements l-F-2 
READMD mode 1-8-3 
Real-time clock 1-6-24 
Record 1-2-2; l-C-5 

Checksum 1-14-4 

Creation date 1-14-4 

Group identifier (refer to gid entry) 

Mark indicators 1-2-3 

Name 1-14-4 

Prefix table 1-9-6; 1-14-4, 13, 14 

Types 1-14-4 
Recording density, magnetic tape 1-2-5 
Reference address (refer to RA) 
Reference record identifier (refer to rid 

entry) 
Reflector, end-of-tape 1-G-l 
Reformatting a file 1-7-23 
Reformatting directives 1-6-28 
REL record type 1-14-2 
Relational operators 1-4-4 
Releasing 

File space 1-7-20 

Files assigned to job 1-7-4; 1-7-32 
Prevention 1-8-6 
Without decrementing the resource 
demand count 1-7-45 

Memory 1-3-6 



Output files 1-3-11; 1-7-18; 1-7-26; 
1-7-33 

Print files 1-2-9 

Punch files 1-2-9 
Remote batch facility (refer to RBF) 
Remote batch origin 1-3-2 

File routing 1-7-37 
Remote batch terminals 1-1-4 
Removable auxiliary devices, maximum 

assigned 1-6-10 
Removing explicit file permission 1-8-4 
Removing files from a permanent file device 

1-8-16,17 
Removing modifications from Modify OPL 

1-13-5 
RENAME statement 1-7-28 
RENAME directive 1-14-16 
Renaming 

File records 1-14-16 

Files 1-7-28 
REPLACE directive 1-14-16 
REPLACE statement 1-8-18 
Replacing indirect access files 1-8-8 
Replacing old file records with records from 

a no-replace file 1-14-16 
REQUEST statement 1-7-29; 1-10-16 
Requesting operator file assignment 1-7-29; 

1-10-16 
Required tape labels 1-G-l 
RERUN statement 1-6-18 
Rerun status 1-6-4,18 
Rescheduling resources l-G-22 
Rescinding deferred route operation 

1-7-33,34 
RESEQ statement 1-7-30 
Reservation blocks 1-2-5 
Reserved file names 1-2-1 
Residency 

File 1-2-12; 1-8-5,13 

Library record group 1-14-20 
RESOURC statement 1-6-18 
Resource 

Demand count 1-6-20 

Overcommitment 1-6-21 

Types 1-6-18 
RESTART statement 1-11-2 
Restarting a job 1-11-1,2 
Retention cycle 1-10-12 
Retention date (refer to Expiration date) 
RETURN statement 1-7-32 
Returning a 

Direct access file 1-8-8 

Pack 1-6-23; 1-8-8 

Tape file 1-6-23 
REVERT statement 1-4-33 
REWIND directive 

LIBEDIT 1-14-17 

SUBMIT 1-6-31 
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1-14-17 
1-6-31 
1-3-5 



REWIND statement 1-7-33 
Rewinding 

Files 1-7-33 

LIBEDIT files 

SUBMIT files 
RFL= entry point 
RFL 

Setting 1-3-6 

Statement 1-6-23 
rid 1-14-11 

RM mode (refer to READMD mode) 
ROFT 1-2-8 
Rolling out a job 1-3-8 
Rollout control 1-3-8 
Rollout files 1-2-11; 1-3-8; l-C-5 
Rollout queue 1-3-8 
ROLLOUT statement 1-6-24 
Rollout time period 1-3-8 
ROUTE statement 1-3-3; 1-7-33 
Routing output files 1-2-9; 1-7-33 
RTIME statement 1-5-6; 1-6-24 
Rubout characters 1-6-10 
Running field length 1-3-5 
Rl 1-4-12 
R2 1-4-12 
R3 1-4-12 
RIG 1-4-12 



S tape format 1-2-7 

ANSI standard 1-10-2 
Sample job 1-D-l 
SAVE statement 1-8-18 
Saving a file 1-8-18 
Scheduling jobs 1-3-5 
Scheduling packs 1-6-18 
Scheduling resources 1-6-18 
Scheduling tape units 1-6-18 
SCP 1-6-12 
Scratch files used by system and language 

processors 1-2-1 
SDM = entry point 1-5-3 
Section number l-G-5 
Security 

Control 1-3-9 

Count 1-6-31,34 

Restrictions 1-3-9 
Semiprivate files 1-8-2 

Granting access to 1-8-16 
Sense switch 1-6-15, 16, 33 
Separators 1-5-2 
SEQ directive 1-6-29 
Sequence number 1-10-12; l-C-5 
Sequential access file 1-14-1; l-C-5 
Serial processor 1-6-33 
Set identifier 1-10-12; l-G-5 
SET statement 1-4-12 



SETASL statement 1-6-24 
SETCORE statement 1-6-2 5 
SETID statement 1-7-37 
SETJSL statement 1-6-26 
SETPR statement 1-6-26 
Setting 

Job rerun status 1-6-18 

Sense switches 1-6-33 

SRU limits 1-3-7; 1-6-24,26 

Symbolic name values 1-4-5, 12 

Terminal characteristics l-E-3 

Terminal parity l-E-3 
SETTL statement 1-3-7; 1-6-27 
Seven-track code conversion l-A-10 
Sharable packs 1-6-23 
Short PRU l-C-5 
SI tape format 1-2-7 
SI coded tape file conversion 1-7-40 
SKIP statement 1-4-7 
Skip termination 1-4-8 
SKIPEI statement 1-7-38 
SKIPF statement 1-7-38 
SKJPFB statement 1-7-38 
Skipping 

Control statements 

Conditional 1-4-8 
Unconditional 1-4-7 

Files 1-7-38 

Records 1-7-39 

To EOI 1-7-38 
SKTPR statement 1-7-39 
SORT statement 1-7-39 
Sorting a file by line numbers 1-7-39 
SOURCE file 1-13-3,10 
Source program errors 1-12-1 
Space for direct access file 1-8-5 
Spacing code for 580 PFC printer 1-7-36 
Special accounting privileges 1-6-12 
Special control statements 1-5-6 
Specifying 

Default LIBEDIT record type 1-14-17 

LIBEDIT no- replace file 1-14-16 

LIBEDIT replacement file 1-14-9,15 
SRU 1-3-4,7 

Limit 1-3-7; 1-6-11,24,26 
SS function 1-4-21 
Standard labels 1-G-l 
Statement label field 1-5-1 
Step condition 1-12-4 
Step mode 1-12-3 
STIME statement 1-5-6; 1-6-27 
Stranger data format (refer to S tape format) 
SUBMIT statement 1-3-3; 1-6-27 
Submitting jobs 1-3-3; 1-6-27 
Subroutine 1-12-7 

Subsystem association (refer to Time- 
sharing subsystem association) 
SUI statement 1-6-32 
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SUMMARY statement 1-6-32 
Supported devices 1-1-4 
Suppressing copy of old file records to 

new file 1-14-14 
Suspending job execution 1-6-24 
SWITCH statement 1-6-33 
Symbolic names 

CCL 1-4-5 

For FILE function 1-4-19 
For SET statement 1-4-13 

KCL l-H-1,6 
SYOT (refer to System origin) 
System 

Code l-G-7 

Control statements 1-5-1 

Description 1-1-1 

Hardware 1-1-1 

Job control 1-3-5 

T —1U _** u _ ton 

o uu iidLiic: l— o — o 

Library 1-2-14 

Monitor 1-1-2 

Origin 1-3-2 

Privileges 1-6-11 

Priorities 1-3-5 

Scratch files 1-2-1 

Sequence number 1-3-3 

Software 1-1-5 

Text 1-13-2 

Utility control statements 1-13-1 
System control point (refer to SCP) 
System internal data format (refer to SI 

tape format) 
SYSTEM macro 1-12-5 
System resource unit (refer to SRU) 



TAF 1-1-1 
Tape 

Access restrictions 1-6-20,22; 1-10-9 
Assignment 1-10-1 
Block terminator 1-2-7 
Checkpoint file 1-11-1,2 
Control statement rules 1-10-2 
Control statements 1-10-1 
Code sets l-A-10 
Data formats 1-2-7 

Record and file mark indicators 
1-2-3 
Density 1-2-5 

9-track labeled tape 1-10-2 
Error recovery 1-10-3 
File 1-2-5 

Accessibility 1-10-7 

Character 1-10-8 

Creation 1-10-1 

Identifier 1-10-12 

Section number 1-10-12 



Sequence number 1-10-12 
Set identifier 1-10-12 
Structure 1-2-3, 6 
Label 1-2-6 

Creation date 1-10-12 
Formats 1-G-l 
Listing 1-10-15 
Parameters 1-10-12 
Management 1-6-18; 1-10-1 
Mark 1-2-6; l-C-5; l-G-8, 10 
Mounting 1-10-1 
Noise size 1-2-7 
Owner 1-10-7 
Parity 1-2-8 

Parity errors 1-2-6; 1-10-3 
Processing options 1-10-3 
Recording mode 1-2-5 
Scheduling 1-6-18 
Trailer sequence 1-10-4 
Unit 1-1-4; 1-10-1 

Assignment 1-6-22 
Dismounting 1-6-23 
Maximum 1-6-10 
TCOPY statement 1-7-40 
TDUMP statement 1-7-44 
TEFT 1-2-8 
Temporary files 1-2-10 
Terminal 

Character conversion 1-E-l 
Data input 1-E-l 
Identification code (refer to TID) 
Parity 1-6-10 
Timeout 1-6-12 
Termination 1-3-10 
Terminators 1-5-2 
TEXT record type 1-14-2 
Text editors 

EDIT 1-13-1 
XEDIT 1-13-13 
TID 1-2-9 

Time limit 1-3-7; 1-5-5; 1-6-10,27 
Control 1-3-7; 1-6-27 
Error 1-5-8 
Time of day 1-4-5,18 
Time slice 1-3-8 
Time- sharing 

Character set l-A-2,4 
Code sets l-A-2,4 
Control statements l-E-2 
Dumps 1-9-2,3,4 
Executive 1-1- 1; 1-3-2 
Interface 1-E-l 
Origin type 1-3-2 
Subsystem association 1-8-4, J_8 
Timed/event rollout file 1-2-11; l-C-5 
Trailer sequence, magnetic tape 1-10-4 
TRANACT l-H-2 
TRANS directive 1-5-29 
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Transaction facility (refer to TAF) 
Transaction functions 1-6-11 
Translate control statements 1-5-7 
Transmission mode 1-6-10 
Transparent mode 1-6-29,30 
TRMDEF statement l-E-4 
TT 1-6-10 

TXOT (refer to Time- sharing origin) 
TYPE directive 1-14-18 



UHLa labels 1-G-l, 19 
ULIB record type 1-14-2 

Directory 1-14-19 
UN option 1-8-2 
Underflow condition 1-12-4 
Underflow mode 1-12-3 
Unlabeled tape 1-10-5,9,13 
Unloading tape files 1-10-3, 5, 9 
UNLOAD statement 1-7-45 
UNLOCK statement 1-7-46 
Unprintable characters l-A-9 
UPDATE statement 1-13-9 
Update-formatted. program library file 

1-2-14; 1-13-9,12 
Update to Modify conversion 1-13-12 
Updating a project profile file 1-13-7 
UPMOD statement 1-13-12 
USECPU statement 1-6-33 
User 

Catalog 1-8-2,9 

Header label 1-G-l, 19 

Index 1-3-4 

Library 1-2-14 

Generation 1-14-19 

Number 1-2-11; 1-3-4; 1-6-34; 1-7-36 
Alternate 1-2-11; 1-8-2 
LIBRARY 1-2-13 

Permission 1-8-2,3,8,9 

Privileges 1-6-11 

Programs 1-1-5 

Tape labels 1-G-l, 19 

Trailer label 1-G-l, 19 

Validation 1-6-34 
Limits 1-6-10 

Volume label 1-G-l, 19 
USER statement 1-6-34; 1-8-1 
User's control point dayfile 1-6-3,4 
UTLa labels 1 - G- 1 , 1 9 
UVLa labels 1-G-l, 19 



Validation 1-3-4 

Information 1-6-10 
VERIFY statement 1-7-47 
Verifying 

File date 1-7-47 

File records 1-14-20 

Tape labels 1-10-9 
VFYLIB statement 1-14-20 
Virtual network terminal 1-7-5 
Volume i-C-5 

Accessibility 1-10-7,8 

Header label (refer to VOL1 Label) 

Serial number (refer to VSN) 
VOL1 1-10-1; 1-G-l, 2, 3 
VSN 1-10-1; l-C-5; l-G-3 
VSN statement 1-10-18 



W access mode (refer to Write mode) 

WBR statement 1-9-6 

WHILE statement 1-4-11 

Working file l-C-5 

Write interlock 1-2-12; 1-7-22,32; 1-8-6,7 

Write mode 1-8-4, 7 

Write ring 1-10-4, 5, 13; l-C-5 

WRITEF statement 1-7-50 

WRITER statement 1-7-50 

Writing 

Binary records 

From CM 1-9-6 
To PUNCHB 1-9-5 

File marks 1-7-50 

I format tape 1-2-7 

Record marks 1-7-50 

SI format tape 1-2-7 



X format tape conversion 1-7-40 
XEDIT statement 1-13-13 



V carriage control character 

Validation l-G-12 
Validating the user l-G-34 



1-1-5 



YANK status 1-14-4 



Zero byte terminator l-C-6 
Zero-length PRU /record l-C-6 
Zero- length record 1-14-11 
ZZCCLAx file 1-4-27 
ZZZDUMP file 1-3-9; 1-9-2, 3 
ZZZZxx CCL file checkpointing 1-11-1 
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. * command 1-4-28 On Modify OP L 1-13-4 

12-bit ASCII code set 1-7-21; l-A-1,4, 6 64-character set 1-7-5; l-A-1.2 

54 table 1-3-5 On Modify OPL 1-13-4 

6/12 display code set 1-7-21; l-A-1.4, 6 7/8/9 statement 1-2-3.4; l-C-6; l-F-2 

6/7/8/9 card 1-2-3, 4; l-C-6; l-F-2 77 table (refer to Record prefix table) 

6/7/9 card 1-2-3,4; l-C-6; l-F-2 80-column binary punch output 1-2-9 

63-character set 1-7-5; l-A-1,2 
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